1) What the Make.com API is
OverviewThe Make.com API (often searched as “Make COM API” or “Make.com API”) is Make’s official REST API. It’s designed so you can control and integrate your Make workspace outside the UI: manage organizations and teams, create/update/run scenarios, inspect logs, manage connections to third-party services, handle webhooks, and work with data stores.
Make organizes the API into resource-oriented URLs (classic REST style) with a dedicated API reference. If you’re building an internal admin dashboard, a SaaS product that provisions automations for customers, or a CI/CD-style deployment process for scenarios, the Make API is the interface you’ll use.
What you can build
Scenario deployment tools, “automation as a feature” inside your app, org/team provisioning, webhook monitoring dashboards, data-store powered integrations, connection management, and automated reporting.
What the API is not
It’s not a “third-party app API.” Make connects to other services, but those services have their own APIs. Make’s API is primarily for managing Make itself and its automation assets.
Primary reference: developers.make.com/api-documentation (Getting started, authentication, API reference).
2) Quickstart: make your first API request
Hands-on
The fastest way to confirm your setup is correct is:
(1) create an API token in your Make profile,
(2) call a simple GET endpoint (like listing organizations),
(3) confirm you receive JSON results, and
(4) store the token securely (never in frontend code).
# 1) Set your Make API token as an environment variable
export MAKE_TOKEN="YOUR_MAKE_API_TOKEN"
# 2) Call the Make API (example: list organizations)
curl --request GET \
--url "https://api.make.com/v2/organizations" \
--header "Authorization: Token ${MAKE_TOKEN}" \
--header "Accept: application/json"
Tokens should be stored server-side (secrets manager / environment variables). Exposing tokens client-side makes them easy to steal. Use a backend proxy if you need browser-triggered actions.
3) API key (token), scopes & permissions
AuthenticationMake uses API tokens (often called “API keys” in the UI) that you create inside your Make profile. When you create a token, you choose the scopes (permissions) it can access, and you should store the token value securely because it’s shown in full only once.
How to create a token
Profile icon → Profile → API access tab → Add token → choose scopes + label → create → copy and store safely. Official help: help.make.com/api-key
What scopes mean
Scopes restrict what the token can do (read scenarios vs run scenarios vs manage users, etc.). Use the principle of least privilege: only grant scopes needed for your app.
In most setups, you send the token in the Authorization header (for example Authorization: Token YOUR_TOKEN),
and the API returns JSON. If you get 401 or 403, verify the token is valid and has the required scopes.
If you support multiple customers (multi-tenant), store a separate token per customer organization and isolate logs so tokens never leak. Use a backend “Make client” module so all API calls go through one audited code path.
4) Base URL & Make regions
Endpoints
Make accounts can run in different regions (for example, EU or US infrastructure). In the Make UI and some docs you may see region hostnames like
https://eu1.make.com. For the public API, Make provides an API host and versioned paths (commonly /v2).
Best practice: store your “environment URL” / region configuration in your app settings and don’t hardcode it everywhere. If Make changes region routing or you add multiple regions, you’ll only update it in one place.
Use the official developer hub and API reference: developers.make.com/api-documentation.
5) Make.com API resource map (what exists)
API referenceMake’s API is organized around workspace resources. Here are the most common ones you’ll use in real systems. (This is a “map” so you can design your integration cleanly.)
| Resource | What it represents | Typical operations | Common use cases |
|---|---|---|---|
| Organizations | Top-level container for teams, scenarios, users | List, read, manage org properties | Multi-org dashboards, provisioning, reporting |
| Teams | Sub-units inside an organization | Create, list, update, delete | Access control, organizing automations by dept |
| Users | Members in an org/team | Invite, update roles, remove | Automated onboarding/offboarding |
| Scenarios | Automations (module graphs) that run workflows | Create, update, run, schedule on/off, logs | Deploy automations, run on demand, monitor |
| Connections | Auth/config for third-party apps used in scenarios | Create, list, update, delete | Provision connections for customers; rotate creds |
| Webhooks / Hooks | Inbound triggers + queues for scheduled webhooks | Create/list webhooks, inspect incoming queue | Instant triggers, queued processing, monitoring |
| Data stores | Key/value storage for scenarios and transfers | Create store, manage records | State storage, idempotency, passing data between runs |
| Keys | Custom keychain metadata (for HTTP/encryptor apps) | Manage key metadata and retrieval | Central secret handling inside Make workflows |
The API reference is split by resource (Organizations, Scenarios, Connections, Data stores, Hooks/Incomings, Keys, etc.). Start here: developers.make.com/api-documentation
6) Organizations, teams & users
Account structureIn Make, an organization is the main container that contains teams, scenarios, and users. Your API integration typically starts by determining which organization(s) the token can access, then selecting a target org for operations.
Once you have the org context, you can manage teams (grouping users and assets) and users (inviting, setting roles, removing). This is especially valuable if you embed Make into a product that provisions automations per customer.
Provisioning
Create a team per customer or department, then place scenarios in that team’s space for clean ownership and permissions.
Offboarding
Remove user access automatically when employees leave; reduce risk by rotating connections / tokens and cleaning webhook queues.
Audit
Log which internal user triggered which Make API call, even if a single token is used by your backend service.
7) Scenarios: create, update, run, schedule, logs
Core automationScenarios are Make’s automation workflows—graphs of modules that pull data from one system, transform it, and push it elsewhere. The Make API supports scenario lifecycle operations such as: listing scenarios, getting a scenario, creating/updating, running a scenario, toggling scheduling, and inspecting logs and executions.
Scenario operations are the core of “Make-as-a-platform” integrations. Common patterns include: deploying new scenarios from templates, updating scenario variables per customer, running a scenario on-demand from your UI, and collecting run results for reporting.
Treat scenario updates like deployments: keep version tags, run smoke tests after changes, and store the “blueprint” (scenario definition) in a repository so you can roll back. For on-demand runs, use idempotency keys in your own system to prevent double-triggering during retries.
8) Connections: authentication to third-party apps
IntegrationsIn Make, a connection is the saved authentication/config needed for Make modules to talk to external services (Google, Slack, CRMs, payment processors, etc.). Most apps in Make require a connection. The API provides endpoints to create and manage connections.
If your product provisions workflows for customers, connection management is critical. You may: create a connection when a user authorizes (OAuth), rotate tokens when they expire, or delete connections when customers churn.
Connection types
Many apps use OAuth2; others use API keys or custom auth. Your app should store minimal secrets and pass them securely to Make where needed.
Least privilege
Only create connections with required scopes in the external service, and build monitoring for auth failures that break scenarios.
9) Webhooks in Make: instant triggers vs scheduled processing
Inbound eventsMake supports webhooks as a way to trigger scenarios immediately when data arrives (instant triggers), or to collect webhook requests into a queue and process them on a schedule (scheduled processing). Webhooks are commonly used when an external system can “push” events to Make (for example, “new order created” or “new lead captured”).
Key webhook concepts in Make:
- Instant webhooks: run the scenario immediately on each incoming request (can be parallel or sequential depending on scenario settings).
- Scheduled webhooks: store incoming requests in a queue and process them periodically based on schedule settings.
- Webhook response: Make can return a response to the webhook sender; you can customize it with modules.
- Queue limits: webhook queue size depends on your plan/allowances; when full, Make rejects new webhook data.
- Rate limits: Make can rate-limit webhook intake; excessive requests may receive
429.
Make webhooks overview and behavior details: help.make.com/webhooks
10) Hooks & Incomings: inspecting webhook queues
Queue controlWhen a scenario uses scheduled webhook processing, incoming requests are placed into a webhook processing queue. Make provides API endpoints under “Hooks > Incomings” to inspect and update the webhook processing queue (for example, viewing queued items, deleting problematic items, or managing queue behavior depending on the endpoint features).
Operationally, this is useful when you need observability and recovery: if a scenario fails repeatedly on a certain payload, you can inspect the queue, isolate the bad item, and allow processing to continue without blocking everything.
Hooks → Incomings reference: developers.make.com/api-documentation/api-reference/hooks-greater-than-incomings
11) Data stores: simple storage for scenarios
State & transferData stores are Make’s built-in storage feature used to store data from scenarios or transfer data between scenario runs. You can manage data stores via API endpoints: create stores, update them, and manage records inside a store.
Real-world uses:
- Idempotency & dedupe: store processed event IDs to avoid double-processing in webhook-driven workflows.
- Stateful workflows: store “last processed timestamp” or pagination cursors for polling triggers.
- Cross-scenario handoff: Scenario A writes to a data store; Scenario B reads later (like a lightweight queue/state store).
- Feature flags: store a small configuration map (enabled/disabled) used by scenarios to change behavior.
Data stores reference: developers.make.com/api-documentation/api-reference/data-stores
12) Keys resource: custom keychain metadata
Secrets workflowMake’s API includes a Keys resource that lets you manage and retrieve metadata for authentication keys in a custom keychain. These keys can be used to manage authentication in Make’s HTTP or Encryptor apps similarly to other connections.
When you’re building enterprise-grade automation, separating “connection configuration” from “secret storage” can help: your app can update key references without repeatedly distributing secrets across many scenarios.
Keys reference: developers.make.com/api-documentation/api-reference/keys
13) Pagination & filtering (practical patterns)
API hygieneMany Make API list endpoints (organizations, scenarios, connections, webhooks, logs) return paginated results. Even if your first integration “works” on small accounts, pagination becomes required once organizations grow.
Safe pagination rule
Always code list endpoints as if results are paginated. Request a page size you can handle, loop until no next page, and add safeguards so you don’t accidentally pull millions of records into memory.
Filter early
If the API supports filtering parameters, use them to reduce traffic, stay under rate limits, and speed up your UI. Example: filter by scenario status, updated time, or team where supported.
Tip: If you build a dashboard, cache list responses for a short time (30–120 seconds) so frequent refreshes don’t burn your rate limit.
14) Rate limiting: requests per minute by plan
Limits
Make enforces API rate limits based on your organization plan. The official “Rate limiting” guide lists the default limits as:
Core: 60/min, Pro: 120/min, Teams: 240/min, Enterprise: 1000/min.
If you exceed the limit, you receive 429 with a message like “Requests limit for organization exceeded, please try again later.”
| Plan | Default API limit | What to do in production |
|---|---|---|
| Core | 60 requests / minute | Queue requests; avoid heavy polling; cache list endpoints |
| Pro | 120 requests / minute | Use concurrency caps; backoff on 429; batch operations |
| Teams | 240 requests / minute | Centralize Make API traffic from multiple services |
| Enterprise | 1000 requests / minute | Still use queues; add monitoring; prevent accidental storms |
Use exponential backoff with jitter, cap retries, and use a job queue for bulk operations. Don’t let user actions create “thundering herd” spikes (e.g., batch imports that fire hundreds of API calls instantly).
developers.make.com/api-documentation/getting-started/rate-limiting
15) Errors, retries & debugging
ReliabilityTreat Make’s API like any external dependency: errors will happen (expired tokens, missing permissions, deleted scenario IDs, rate limits, temporary outages). Your integration should classify errors and respond consistently.
Common error classes
400 validation errors, 401 invalid/expired token, 403 insufficient scopes, 404 resource not found, 429 rate limited, 5xx server issues.
Retry policy
Retry only when it makes sense: 429 and some 5xx. Do not retry 401/403 without human intervention (fix token/scopes). Always cap retries and send failures to a dead-letter queue.
1) Confirm correct API host & path • 2) Confirm token is correct • 3) Confirm scopes • 4) Log request IDs / responses (redact secrets) • 5) Validate you’re not exceeding plan limits • 6) If calling scenario run endpoints, confirm scenario exists and is accessible in that org/team.
16) Security & production architecture
Best practicesIf you’re building a serious Make integration (internal tool or SaaS feature), treat it as a production system: a backend service owns tokens, your app enforces who can run which scenario, and you log actions for audit.
Token safety
Store tokens in a secrets manager, rotate when needed, never ship tokens to browsers, and redact tokens from logs.
Policy gates
For scenario runs that can trigger emails/payments/CRM updates, require permissions and optionally an approval step.
Queues
Use a job queue to respect rate limits, smooth bursts, and provide progress tracking for bulk operations.
A solid architecture looks like:
- Frontend triggers “jobs” (not direct Make calls).
- Backend API validates input, checks permissions, creates a job record.
- Worker processes jobs, calls Make API with token, applies retries/backoff, stores results.
- Observability dashboards show success/failure, queue depth, and 429/5xx spikes.
If your app allows users to run scenarios, add per-user rate limits and quotas. Make’s org-level rate limit protects Make, but your product must protect your customers (and your costs).
17) FAQs (Make COM API)
FAQWhat is the Make.com API used for? ⌄
It’s used to manage Make itself: organizations, teams, users, scenarios (create/run/schedule/logs), connections, webhooks/hook queues, and data stores—so you can automate Make administration or embed Make into your product.
How do I get an API key (token) for Make? ⌄
Go to Profile → API access → Add token, choose scopes and a label, then copy and store the token safely. Official steps: help.make.com/api-key.
What are scopes, and why do they matter? ⌄
Scopes restrict what your token can do. Only grant the minimum scopes needed (least privilege), especially if your integration can run scenarios or manage users/connections.
What are the Make API rate limits? ⌄
Make sets API rate limits by plan (requests per minute): Core 60/min, Pro 120/min, Teams 240/min, Enterprise 1000/min. If exceeded, you’ll get HTTP 429.
What’s the difference between Make API webhooks and “webhooks in scenarios”? ⌄
“Webhooks” in Make are how scenarios receive inbound events. The Make API can help you manage/inspect webhook resources and, for scheduled webhooks, inspect the webhook queue (Hooks → Incomings).
Can I call the Make API directly from a website frontend? ⌄
Not recommended. Your token would be exposed. Use a backend proxy and enforce your own authentication, authorization, and logging.