Procore
Connect Procore to Ploy to see everyone in your Procore company directory, the company permission template each person holds, who has been deactivated, and who is in each project's directory. Ploy can also add people to your company, deactivate and reactivate them, change their company permission template, and add or remove them on a project.
This integration is in beta
The Procore integration is in beta. It was built from Procore's API documentation and has not yet been checked against a live Procore company, so some details may need adjusting once customers connect it. Beta does not limit what the integration can do.
The first step of setup is a consent checkbox. Ticking it lets Ploy capture redacted error data when a request to Procore fails: the error response Procore sends back, with personal details, tokens and other secrets removed. Ploy uses it only to fix problems with this integration. You must tick the box to continue.
What Ploy reads
Every active person in your company directory, with their name, email address and employee ID
Each person's company permission template
Every deactivated person in your company directory
Every active project the Ploy app is permitted to see
Who is in each of those projects' directories, and the project permission template they hold there
Ploy does not read company people without a Procore login, contacts, vendors, project roles or project tool data.
What Ploy can change
Add a person. Ploy adds them to your company directory with their name and email address, then Procore emails them an invitation to set up their login. Someone who is already an active user is left as they are.
Deactivate and reactivate a person. Deactivating keeps their record, so they can be reactivated later. Procore has no way to delete a user.
Change a person's company permission template. Choose the template by its name. This needs Directory Admin access for the app (see below).
Add or remove a person on a project. From a project's page in Ploy. Removing someone from a project leaves them in the company and on their other projects. Removing someone who is already gone counts as done.
Before you start
Ploy connects through a Procore app with a service account that belongs to your company. You create the app yourself in the Procore Developer Portal:
Sign in to the Procore Developer Portal with a Procore account that is a company administrator.
Create a new app and choose the Data Connector type.
In the app's Data Connector Components, enable a service account at both the company level and the project level.
Give the service account read access to the Directory tool at the company and project level, so Ploy can scan. For Ploy to add, deactivate and reactivate people and manage project access, give it admin access to the Directory tool instead. Changing a person's permission template needs Directory Admin.
Create a production version of the app, then install it in your Procore company from the App Marketplace or with the app's install link.
While installing, choose the projects the app may access. Ploy only sees the projects you permit here.
Copy the app's production client ID and client secret. Treat the secret like a password.
Installing the app adds a directory user for the service account to your company. That user appears in Ploy like anyone else.
Connect Procore in Ploy
In Ploy, open Integrations and choose Procore.
Tick the beta consent checkbox.
Paste the client ID and client secret, then continue.
Choose your Procore company from the list. If it is missing, install the app in that company first.
Click Test. Ploy reads one person from your company directory to check the connection works.
Finish the setup. The first scan starts straight away.
To connect a second Procore company, add another Procore connection and choose that company.
Things to know
The company directory and deactivated users are checked every hour; projects and project directories every 6 hours.
A person deactivated in Procore loses their access in Ploy at the next scan.
A person removed from a project loses their project access in Ploy at the next scan of that project.
A project made inactive in Procore is archived in Ploy.
If the app was permitted on only some projects, the others do not appear in Ploy. Permit more projects in Procore's App Management to add them.
Troubleshooting
Procore rejected the client ID and secret
Check both were copied in full from the production version of the app, and that the app is still installed in your company.
No company appears in the list
The app is not installed in any company yet. Install it, then go back to the company step.
Procore refused to read the company directory
Give the app's service account read access to the Directory tool at the company level, then test again.
Changing a permission template was refused
Give the app's service account Directory Admin access, then try again.
Adding someone to a project was refused
Check the app is permitted on that project and its service account has admin access to the Directory tool at the project level.