Bridgit Bench and Procore API samples

The below demonstrates how to pull data from Procore and push it to Bridgit Bench using available public REST APIs. Perfect for subcontractors managing data transmission from Procore to Bridgit Bench.

WHAT YOU’LL NEED

In order to begin the process, you’ll need the following items:

• A Bench account and user credentials 
  • Authorization
• A Procore Sandbox with OAUTH2 credentials and user credentials
  • Sandbox Environments
  • OAuth 2.0 Access Tokens

STEPS TO INTEGRATE:

• Configure Environment Variables
• OAuth2 Setup
• Procore – Authorization
• Procore – Get Project(s)
• Procore – Get Project Details
• Bridgit Bench – Sign In
• Bridgit Bench – Account ID
• Bridgit Bench – Create Project

EXAMPLES AVAILABLE FOR DOWNLOAD:

• Postman Environment
• Postman Collection

CONFIGURE ENVIRONMENT VARIABLES

First, you’ll need to configure your environment variables to limit the modifications you’ll need to make later on when data changes.

OAUTH2 SETUP

Setup OAuth2 in Postman to get an authorization code. See Generating OAuth 2.0 Tokens in Postman for step by step instructions.

PROCORE – AUTHORIZATION

Next you’ll need to complete a POST request to Procore to authorize the subsequent Procore requests to retrieve data.

Example:

PROCORE – GET PROJECT(S)

To get a complete list of your company’s projects from Procore, run a GET request to the following path.

Example:

GET 
https://{{procore_sandbox_url}}/vapid/projects?company_id={{procore_company_id}}

PROCORE – GET PROJECT DETAILS

Then to get complete project details, you have to run a second GET request to the following subpath.

Example:

GET
https://{{procore_sandbox_url}}/vapid/projects/{{procore_project_id}}?company_id={{procore_company_id}}

BRIDGIT BENCH – SIGN IN

Next, POST an authentication request to authenticate for subsequent Bench requests. See the Authentication instructions here.

Example:

BRIDGIT BENCH – ACCOUNT ID

To retrieve your Bench Account ID, complete another GET request to Bench.

Example:

GET
https://{{bench_url}}/rp/api/v1/Accounts

BRIDGIT BENCH – CREATE PROJECT

Now, finally, let’s create a project. Complete a POST request to Bench with the Procore project parameters required by Bench.

Example:

POST 
https://bench.gobridgit.com/rp/api/v1/accounts/{{bench_account_id}}/projects

Example Post Body:
{
	“name”: “{{procore_project_name}}”,
	“colour”: #ffc0cb”,
	“startDate”: “{{procore_project_start}}”,
	“endDate”: “{{procore_project_end}}”
}

Example Response Body:

{
	“Id”:10118,
	“name”: “Sandbox Test Project”,
	“colour”: “#ffc0cb”,
	“startDate”: “2018-01-11”,
	“endDate”: “2019-05-08”,
	“state”: “Complete”
	“unfilledRoles”: 0,
	“totalRoles”: 0,
	“issueCount”: 0,
	“lastModification”: 2019-11-07T21:06:16.2455388Z”,
	“currentPhases”:[]
}