BIM 360

BIM 360 is a unified platform connecting your project teams and data in real-time, from design through construction, supporting informed decision-making and leading to more predictable and profitable outcomes.

The following sections provide prerequisites, resources, and instructions for integrating with SaaS Management.

• Stored BIM 360 Information
• Required Minimum Permissions for BIM 360
• BIM 360 Authentication Method
• Required BIM 360 Credentials
• Integrating BIM 360 With SaaS Management
• BIM 360 API Endpoints

Stored BIM 360 Information

The following table describes the available integration tasks and stored data.

Available Integration Tasks

Information Stored

Application Roster
• User ID
• Email
• First Name
• Last Name
• Active Date

Application Access
• User ID
• Last Login

Note:The information stored is subject to change as enhancements are made to the SaaS application.

Required Minimum Permissions for BIM 360

Administrator-level access and the BIM 360 OAuth Scope are required to connect your application to a specific BIM 360 Account. For details, see BIM 360’s documentation section Get Access to a BIM 360 Account.

BIM 360 OAuth Scope

OAuth Scope

Description

Integration Tasks

account:read

To read the list of users in your BIM 360 account. For more details, see the GET users section of the BMI 360 API Reference.

Application Roster

Application Access

BIM 360 Authentication Method

OAuth2 Client Credentials. For details, see BIM 360’s documentation section Get a 2-Legged Token.

Required BIM 360 Credentials

• Client ID
• Secret ID
• Hosted Region
• Account ID

Integrating BIM 360 With SaaS Management

To integrate BIM 360 with SaaS Management, perform the following tasks for the US and EMEA regions.

• Creating an Application in Autodesk Forge
• Getting Administrator Access to a BIM 360 Account
• Inviting Developers to a BIM 360 Account
• Integrating BIM 360 With SaaS Management

Note:For additional BIM 360 information, see:

• Create an App 
• Connect Your App to a Specific BIM 360 Account 

Creating an Application in Autodesk Forge

To create an application in Autodesk Forge, perform the following steps.

To create an application in Forge Portal:

1. Sign in to the Forge portal https://forge.autodesk.com with the appropriate US or EMEA region credentials.
2. To register an application, go to the Profile menu on the top right of the page and click My Apps.
3. Click the CREATE APP button on the top-right of the My Apps page. The Create App page opens.
4. Select BIM 360 API for the APIs the application will access.
5. Enter the required fields to create an application:
• App Name 
• App Description 
• Callback URL: You can enter https://test.com. Three-legged flows specify a redirect_uri at runtime, which must match the pattern specified here to esnure the security of your app. The redirect_uri is the URL of your app that the Forge Platform sends the end user to after acquiring authorization for the app.

Click CREATE APP.

6. Document your Client ID and Client Secret. After you register an application, you will see a Client ID and Client Secret, and Callback URL in your newly created application page.

There are two ways to connect your application to a specific BIM 360 account, depending on your account permissions.

• If you are the Account Administrator on your BIM 360 account, complete the steps for Getting Administrator Access to a BIM 360 Account.
• If you need to be added as a Developer by the Account Administrator on the BIM 360 account, complete the steps for Inviting Developers to a BIM 360 Account.

Getting Administrator Access to a BIM 360 Account

If you need administrator access to a BIM 360 account, perform the following steps.

To get adminstrator access to a BIM 360 account:

Note:You will need your Client ID to complete the following steps.

1. Sign in to the appropriate Host Region portal.
• For the US Region, sign in to the BIM 360 portal at https://admin.b360.autodesk.com/ 
• For the EMEA Region, sign in to the BIM 360 portal at https://admin.b360.eu.autodesk.com/ 

Note:Currently BIM 360 only supports the US and EMEA regions. For the APAC region, sign in to the appropriate portal where the account is hosted.

2. On the Account Admin screen, select the Settings tab. Then click the Custom Integrations tab. In the Add Custom Integration dialog, give your application access to BIM 360 Account Administrations.

Then click Next.

3. Select I'm The Developer and click Next.
4. Copy and save the BIM 360 Account ID, and select the box beside it.

Note:For further information on how to get the BIM 360 Account ID, see Getting the Account ID.

5. Enter the Client ID, application name, and description. Review your information and click Save. You will receive a Adding a Developer to a BIM 360 Account message stating that your application is connected to your BIM 360 account.

Inviting Developers to a BIM 360 Account

To be invited to a BIM 360 account, the developer requesting account access performs the following steps.

To invite a developer to a BIM 360 account:

1. Sign in to the appropriate Host Region portal and click the Custom Integrations tab. In the Add Custom Integration dialog, give your application access to BIM 360 Account Administration. Then click Next.
2. Select Invite a Developer and enter your email address. An invitation email will be sent to you.
3. Click the link in the invitation email to sign in to your Autodesk account.
4. Enter and save your application’s Client ID, name, description, and logo.
5. Wait for your Account Administrator to approve your access to the requested BIM 360 account.

Integrating BIM 360 With SaaS Management

To integrate BIM 360 with SaaS Management, add the BIM 360 application in SaaS Management. For details, see Adding an Application.

BIM 360 API Endpoints

Application Roster and Application Access:

• URI (US) https://developer.api.autodesk.com/hq/v1/accounts/:account_id/users
• URI (EMEA) https://developer.api.autodesk.com/hq/v1/regions/eu/accounts/:account_id/users