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)
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).
After enabling cross-company access in Agave Link, your customer will have the option to select multiple companies after authenticating with Procore:
You can now use the
Company-IDheader 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' \
To retrieve a list of Companies for the Account Token, see the Companies endpoint.