Skip to main content
Welcome to Automate CRM. Follow this guide to obtain your API credentials and execute your first authenticated request against the CRM Integration API.

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 for GET, HEAD, and OPTIONS requests.
  • crm:write: Required for POST, PATCH, PUT, and DELETE requests.
Copy and securely store your API key immediately upon creation. For security reasons, the key will not be displayed again.
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.