New Users (No active token or Databricks connection)

1. A guided onboarding wizard opens automatically.

2. Follow the prompt to select your data platform and generate credentials.

3. (Optional) Click Skip Setup to go to the 'Data Connectors' page and complete setup later via the Connect Your Data card.

   

Existing Users (With an active token or Databricks connection)

1. Read the one-time welcome message summarizing changes.
   Note: Existing tokens/connections transfer automatically without needing regeneration.

   

2. Select Add Platforms.

3. Mark the checkbox next to each data platform your company currently uses (e.g., AWS, Azure, BigQuery, Databricks, Power BI, Snowflake, SQL Server).

4. Click Continue.
   Note: The selected connections will be marked as connected in your Analytics dashboard.

   

Data Connectors Page Layout

• Left Panel (Platforms):

  • Active Connections: Displays cards for added platforms with their setup checklists and status.

  • Available Platforms: Lists supported platforms (AWS, Azure, BigQuery, Databricks, Power BI, Snowflake, SQL Server, Build Your Own, and Other) with a search box.

• Right Panel (Credentials): Displays bearer token details, expiration countdowns, share names, Delta Sharing server URLs, share credential versions, data sync status, and linked Procore companies.

  

Platform Connection Checklist

Every added platform uses a 3-step checklist tracked on its platform card:

1. Configure Authentication: Choose and set up a Security Token or OIDC Authentication.

2. Access Connection Kit: Download the technical guides and assets required for platform setup.
   Note: Power BI, Build Your Own, and Other platforms use an inline step-by-step guide instead of a downloadable kit. Databricks skips to completion upon successful direct connection.

3. Confirm Connection: Confirm setup completion to mark the connection status as active.

   

Platform Connection Statuses

Each platform card displays one of the following statuses:

• Setup in Progress: One or more checklist steps are incomplete.

• Connected: All checklist steps are completed.

• Connection Interrupted: The underlying credential was deleted. The platform resets to Step 1 in the connection checklist, requiring re-authentication.

Option 1: Security Token

1. Generate a personal access token by selecting a fixed duration or a specific expiration date.

2. Copy and save all token details immediately before closing the window.
   Note: Procore does not store your token, and it cannot be recovered after the window closes.

3. Monitor token validity using the Active — {N} days left countdown card on the Data Connectors page.

   

Note: Expired tokens cannot be extended. Delete the expired token and generate a new token to restore platform data sync.

Option 2: OIDC Authentication

You can now authenticate through your organization's identity provider using OpenID Connect authentication for centralized and secure access.

1. Retrieve four required values from your organization’s identity provider: Issuer URL, Subject Claim, Subject, and Audiences.

2. Enter these four values into the setup form.
   Note: OIDC generates no token to store and has no expiration cycle.

3. Access the Credentials tab on the 'OIDC' card to copy or download .share files for three profile types:

   • Power BI Connection URL: For direct Power BI integration.

   • Tableau and Other BI Tools (tableau-profile.share): OAuth authorization-code profile.

   • Machine-to-Machine (m2m-profile.share): OAuth client-credentials profile for automated server-to-server access.

     

4. (Optional) Open the downloaded M2M .share file and replace the placeholder values for clientId, clientSecret, and scope before attempting a connection.

Option 3: Databricks Direct Connection (Admin Only)

1. Enter your workspace sharing identifier into the setup prompt.
   Note: A setup guide is linked in the flow if you need help locating your identifier.

2. Submit to complete authentication and connectivity in a single step.

Note: Security Token and OIDC authentication methods are alternatives. You configure one authentication method per connection. Once an authentication method is active, reopening it shows the credential details rather than the setup form.

Budget and Forecasting View

The standalone 'Budget and Forecasting' tab has been integrated into this section.

• Custom Views & Inline Saving: Override Procore Standard budget and forecasting views with custom budget and forecasting views. All changes now save inline.

• Data Preparation Tracking & Status: Custom budget and forecasting data must be prepared before it appears in Analytics reports. A new progress panel displays real-time status (ETA, percentage complete) and a Last synced timestamp once complete.

• Instant Data Preparation: Procore Standard budget and forecasting views require no preparation time.

• View Switching: Selecting a different custom budget or forecasting view automatically restarts data preparation.

Public Photo Link Access

The controls for public photo links are now available in the 'Data Configuration' page with additional safeguards:

• Enable/Disable Toggle: Control whether anyone with a link can download photos without logging in to Procore. Enabling this feature requires acknowledging a security disclaimer, since publicly accessible links are open and unprotected.

• Update Links: Regenerates all photo links across the company. Any previously shared links will stop working immediately, ideal for revoking external access.

• View History: Track every action with a complete audit log showing who made a change, when it occurred, and the exact action taken (Enabled, Disabled, Links Updated, Update in Progress, or Update Canceled).