Procore

The Procore connector facilitates workflows such as processing payroll, managing employee information, and generating compliance reports.

User Access

To access the developer environment for Procore, see the Registering a New Developer Account and Sandbox Environments topic at the Procore Developers Documentation Repository.

Engagement and Training

If you would like additional training or to ask for enhancements to this connector, please view the following resources:

• Procore Developers Support

• Procore API / Developers Community

Technical Documentation

Technical documentation for this product may be viewed at the Procore Developers Documentation Repository.

Connector Endpoints

The documentation below is an OpenAPI description (OAD) of each module in this connector.

Note: This is provided as a quick view of coverage and capabilities. The API and endpoints documented are used internally by the platform and not directly by end users.

• Procore v2

Note: ERP endpoints are not available for App Xchange customers.

Connection in App Xchange

The Procore connector has not yet been updated to use a formally defined connection. Details on configuring this connector and providing the credentials needed for integration usage are provided below.

Additional Configuration

Before you can use the Procore connector, you must Install a Procore marketplace app into your Procore account. If no Procore Marketplace apps meet your requirements, you can create your own custom app to acquire the Client ID and Secret to use in App Xchange. If you need additional information, please visit developers.procore.com.

Connection Details

Navigate to Workspace > Integrations, select + Add Connection next to this connector, and enter values in the following fields.

• Real-time Action Processing: This feature should always be enabled for optimal performance. Only disable it if you are advised to do so by support.

Procore API Details

• Base URL: https://api.procore.com/ (default)

Note: API requests to the Procore connector use this same base URL at the beginning of each request.

• OAuth Grant Type: Select the type of OAuth grant used for authentication.

Authorization Code Override Settings

• Initiate URI: Enter the Initiate URI with possible URI replacements for ClientId ${ClientId}, State ${State}, and RedirectURI ${RedirectUri} if OAuth is using V2. For example, https://login.ryvit.com/oauth/authorize?response_type=code&client_id=${ClientId}&redirect_uri=${RedirectUri}&state=${State}.

• Authorize URI: Enter the Authorize URI. For example, https://login.ryvit.com/Connect/Begin.
  Note: This field is only required if using V1.

• Token Request URI: Enter the Token Request URI with possible URI replacements for Code ${code}, ClientId ${clientId}, ClientSecret ${clientSecret}, RedirectURI ${redirectUri} For example, https://login.ryvit.com/oauth/token?grant_type=authorization_code&code=${code}&client_id=${clientId}&client_secret=${clientSecret}&redirect_uri=${redirectUri}.

• Refresh URI: Enter the Refresh URI with possible URI replacements for RefreshToken ${refreshToken}, ClientSecret ${clientSecret}, and ClientId ${clientId}. For example, https://login.ryvit.com/oauth/token?grant_type=refresh_token&client_id=${clientId}&client_secret=${clientSecret}&refresh_token=${refreshToken}.
  Note: This field is only required if using V2.

• Client Id: Contact the owner of the target app to populate the Client Id into your connector configuration within App Xchange.

• Client Secret: Contact the owner of the target app to populate the Client Secret into your connector configuration within App Xchange.

• OAuth Version: Select if the System uses V1 or V2 of OAuth.

Client Credentials Override Settings

• Token Request URL: https://login.procore.com/oauth/token (default)

Note: This does not have to be set unless pointing to an environment other than the normal Base URL.

• Client Id: Contact the owner of the target app to populate the Client Id into your connector configuration within App Xchange.

• Client Secret: Contact the owner of the target app to populate the Client Secret into your connector configuration within App Xchange.

• CompanyId: Enter the number assigned to your company in Procore. Log in to Procore and copy the number in the URL that displays after app.procore.com. For example, https://app.procore.com/112233/company/home/thumbnail.

Note: The Company Id can also be retrieved by accessing your service account with the Procore administration tool.

System Interface Configuration

• Base Url of the Ryvit AppNetwork Environment: https://api.xchange.trimble.com/connect/v1 (default)

• Partner Api Key: This field is pre-populated with a unique API key issued to you by App Xchange.

Select Save to save your changes. The connector is connected.

User Support

If you encounter a problem or need support for this connector, please create a ticket at App Xchange Support or email xchange_support@trimble.com.