Configuration

These additional connector settings must be configured in App Xchange.

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 these 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.