Prerequisites
Before getting started, make sure you have:- Access to your Automate CRM workspace.
- Administrative permissions to generate integration API keys.
- A tool for making HTTP requests (such as
curl, Postman, or Node.js).
1
Step 1: Obtain your workspace API key
Log in to your Automate CRM dashboard and navigate to Settings > Developer & Integrations. Generate a new API key with the required scopes:
crm:read: Required forGET,HEAD, andOPTIONSrequests.crm:write: Required forPOST,PATCH,PUT, andDELETErequests.
2
Step 2: Understand workspace resolution
Your API key implicitly identifies and isolates your workspace.
Do not include a workspace ID in request paths or request bodies. The server resolves all tenancy automatically from the
x-api-key header.3
Step 3: Execute your first API call
Make a request to list the leads currently in your workspace. Include your secret key in the
x-api-key header:Sample read response
Next steps
Now that you have authenticated with the CRM API, explore our core feature guides and endpoint references:Manage leads
Learn how to create deals and transition them through pipeline stages.
API authentication
Read complete details on scopes, error handling, and security best practices.
