Skip to main content

Frequently Asked Questions

1. How do I support authenticating with more than one Procore Company?​

If your customer's use-case requires that they need to authenticate with multiple Procore Companies (e.g. they are a Subcontractor needing access to multiple General Contractor Procore Companies)

  1. You will need to enable cross-company access in Agave Link. To enable cross-company access, see Agave Link - Advanced Examples (specifically, the Require Cross-Company Access (Procore) tab).

  2. After enabling cross-company access in Agave Link, your customer will have the option to select multiple companies after authenticating with Procore:

  3. You can now use the Company-ID header to select which Procore Company to make requests to for a customer that has authenticated with cross-company access:

curl --request GET https://api.agaveapi.com/projects \
     --header 'API-Version: 2021-11-21' \
     --header 'Client-Id: your_client_id' \
     --header 'Client-Secret: your_client_secret' \
     --header 'Account-Token: account_token' \
     --header 'Company-Id: <company_uuid>' \
     --header 'Content-Type: application/json' \
     --data-raw '{
    }'

To retrieve a list of Companies for the Account Token, see the Companies endpoint.