Search API Connector Documentation
Import Procore Data to Sheets
In this guide, we’ll walk through how to pull Procore data directly into Google Sheets, using the API Connector add-on for Sheets.
Contents
- Before You Begin
- Part 1: Connect to the Procore API
- Part 2: Create your Procore API Request URL
- Part 3: Pull Procore API Data into Sheets
- Part 4: More Example API URLs
- Part 5: Handle Pagination
- Part 6: API Documentation
Before You Begin
Click here to install the API Connector add-on from the Google Marketplace.
Part 1: Connect to the Procore API
If you haven’t connected API Connector to Procore before, you’ll first need to initiate the connection as follows:
- Open up Google Sheets and click Extensions > API Connector > Manage Connections.
- In the list of available connections, find Procore and click Connect.
- You will be taken to Procore.com and asked to provide API Connector with access your account.
- You will now be returned to your Google Sheet, and can verify that your Procore connection is active in the Connections screen.
Part 2: Create Your Procore API Request URL
For our first request, we’ll get a list of all submittals for a specified project.
- API root: https://api.procore.com
- Endpoint: /rest/v1.0/projects/project_id/submittals
Putting it together, we get the full API Request URL:
https://api.procore.com/rest/v1.0/projects/11111111/submittals
Just substitute in your project ID.
Tip: you can find your project ID by checking the URL while logged into the Procore website. Alternatively, you can get it with a request to https://api.procore.com/rest/v1.0/projects?company_id=company_id
Similarly, you can get your company ID through the Procore website URL or via a request to https://api.procore.com/rest/v1.0/companies
Part 3: Pull Procore API Data into Sheets
Now let’s plug that into API Connector.
- Back in the Create Request interface, enter the Request URL we just created above.
- Under Authentication, choose “Procore” from the drop-down menu. You should see a “Connected” badge.
- We don’t need any headers for this request, so just leave that section blank.
- Create a new tab and click Set current to use that tab as your data destination.
- Name your request and click Run. A moment later you’ll see some data populate your sheet.
Part 4: More Example API URLs
You can experiment with endpoints and query strings as described in the Procore API documentation, but if you just want to jump in, play around with the URLs you enter in the API URL path field. Try the following (one at a time), substituting in actual values where indicated.
- Get tasks associated with a project
https://api.procore.com/rest/v1.0/tasks?project_id={project_id}
- Get budget metadata
https://api.procore.com/rest/v1.0/projects/{project_id}/budget
- List programs
https://api.procore.com/rest/v1.0/companies/{company_id}/programs
- List people associated with a company
https://api.procore.com/rest/v1.0/companies/{company_id}/people
- Get a list of project dates
https://api.procore.com/rest/v1.0/projects/{project_id}/project_dates
Part 5: Handle Pagination
By default, Procore limits the number of records in a response. To get more records you need to use the “page” and “per_page” parameters as shown in their documentation.
In API Connector this can be automated as follows:
URL: enter your URL, including per_page=10000
Pagination: page parameter
Page parameter: page
Run until: choose when to stop fetching data
Part 6: API Documentation
Official API documentation: https://developers.procore.com/reference/rest/v1/authentication?version=1.0