Autodesk Construction Cloud

Hardline connects to Autodesk Construction Cloud through Autodesk Platform Services (APS) OAuth. Autodesk supports OAuth-based access so applications can access data without handling user passwords.

Provider docs:

• Autodesk Authentication API overview
• Autodesk OAuth token endpoint
• Autodesk OAuth basics

What you need

• An Autodesk admin who can create or approve an APS app.
• An APS app client ID and client secret.
• The ACC account or hub ID.
• The ACC project ID.
• Permissions for the ACC modules you want Hardline to use.

Recommended auth model

Start with Client credentials for server-to-server access where Autodesk supports it.

Some ACC workflows and endpoints require user-context authorization or secure service account behavior rather than plain two-legged client credentials. If a required workflow fails with an authorization or user-context error, use an Autodesk OAuth authorization-code setup that stores a refresh token for the service account, or contact Hardline support to enable that provider connection mode.

Hardline already supports resolving OAuth refresh-token credentials server-side. The simple web setup flow currently exposes the low-risk client-credentials path first.

Create the Autodesk app

1. Sign in to the Autodesk Platform Services portal.
2. Create an app for the Hardline integration, or open the existing app your organization wants to use.
3. Copy the client ID.
4. Copy the client secret. Store it securely.
5. Enable the Autodesk APIs and products needed for your ACC workflows.
6. In Autodesk Construction Cloud admin, make sure the app or service account is allowed for the account and project you want Hardline to access.
7. Record the ACC account or hub ID.
8. Record the ACC project ID.

Connect Autodesk in Hardline

1. Open Hardline.
2. Go to Settings > Integrations.
3. Select Autodesk.
4. Click Add credentials.
5. Choose Client credentials.
6. Use this token URL:

https://developer.api.autodesk.com/authentication/v2/token

7. Paste the APS client ID.
8. Paste the APS client secret.
9. Enter the ACC account or hub ID in Account ID.
10. Enter the account name in Account name.
11. Add a default project name if most assistant work should use one project.
12. Save the connection.
13. Click Test connection.
14. Enable the Autodesk tool policies your team wants available.

OAuth refresh-token setup

Use this path only when the Autodesk workflow requires user-context access.

1. Create an APS app with the required callback URL and scopes.
2. Have the service account user complete the Autodesk authorization-code flow.
3. Exchange the authorization code for an access token and refresh token through Autodesk’s token endpoint.
4. Store the refresh token through Hardline’s integration configuration path.
5. Test the connection before enabling write tools.

Autodesk refresh tokens should be treated as sensitive long-lived credentials. When the refresh token is used, Autodesk may return a replacement refresh token. Hardline stores the replacement in server-side secret storage.

Troubleshooting

Symptom	What to check
Token request fails	Confirm the client ID, client secret, and token URL are correct for APS OAuth v2.
ACC project data is missing	Confirm the app or service account is authorized for the ACC account and project.
Endpoint requires user context	Switch from client credentials to an OAuth refresh-token setup for the service account.
Writes fail but reads work	Confirm module-level permissions in ACC and review the scopes granted to the app.