Authentication
All requests to our API must be authenticated and authorized. Additionally, we require clients to use a static IP address for the servers making API calls. These IP addresses will be added to our allowlist to enhance security.
The API token must be provided in the authorization header for all requests, for example:
curl -X 'GET' \ 'https://api.gettrail.com/api/v1/contacts/search?searchString=Duy&page=1&page_size=10' \
-H 'accept: text/plain' \
-H 'Authorization: bbc9b40410c447daf290e915b9c1e37c4a9edccc20'
How to find the API token
The API token will only be accessible if Trail has enabled API access for your organization.
If your organization has API access
You can get the API token manually from the CRM app by going to Organization settings (on the bottom left) > Integrations > API Access.
Disclaimer: Never disclose your real API token! If it is compromised please immediately regenerate the key.
If your organization does not have API access
If you don't see API Access in the Integrations tab in Organization settings you will need to contact the support team at support@gettrail.com.
Keep in mind that an API token is tied to manager roles and company in Trail CRM, giving access to all user's data. You can only have one active API token for a company at any time. If you change the API token, all existing integrations using this API token will not be able to make successful requests against our API and stop working.