Create a New Project
The BIM 360 API allows automation of project creation workflows and populating project profiles programmatically, thereby reducing manual data entry and improving data quality. Using the BIM 360 API, you can bring in project information from external systems, such as enterprise resource planning (ERP) or financial systems, and make it consistent across BIM 360 services and the rest of your construction ecosystem. This tutorial explains how to create a new BIM 360 project in your account.
Before You Begin
Make sure that you have registered an app. and successfully acquired an OAuth token with the account:write
scope.
Make sure that you have access to the BIM 360 account that you want to create the project in and have acquired the account_id
. In order to access a specific BIM 360 account, you need to have completed the steps detailed in the Get Access to an Account tutorial.
Step 1: Create a New Project
The BIM 360 API exposes a POST projects endpoint that allows creation of a new BIM 360 project and populating the project profile information.
Example Request
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 9ezBnx9Rd5D1xG4KMt6b72T4w0MG" https://developer.api.autodesk.com/hq/v1/accounts/e3d5ef8d-5c37-4b9d-925d-1e6d24753ace/projects -d '
{
"name": "construction_project",
"service_types": "field",
"start_date": "2015-05-02",
"end_date": "2016-04-03",
"project_type": "office",
"value": 3000,
"currency": "USD",
"job_number": "0219-01",
"address_line_1": "The Fifth Avenue",
"address_line_2": "#301",
"city": "New York",
"state_or_province": "New York",
"postal_code": "10011",
"country": "United States",
"business_unit_id": "c17e6837-96cd-4839-868e-051a2ad65d28",
"timezone": "America/New_York",
"language": "en",
"construction_type": "Renovation",
"contract_type": "Design-Bid"
}'
This creates a BIM 360 project with project information that is accessible and available for BIM 360 Field. Please take a note of the value of the project_id
attribute in the response body. This is the BIM 360 project ID that needs to be specified if you want to Activate a Service in your project.