What we do
Tools
Industries
Department
How we workLet's talk →
Home/Monday CRM/monday.com API for CRM
monday.com developer reference

The monday.com API for monday CRM Boards: Auth, Versions, Limits and Webhooks

monday.com has one GraphQL API for every board, and monday CRM's leads, contacts and deals are boards like any other. A deal is an item, its stage is a status column, its value is a numbers column. Here's what you need to make calls that keep working: the token, the version header, the limits that end a sync early, and webhooks so you don't have to poll.

The essentials

Endpoint: POST https://api.monday.com/v2 with a GraphQL query in the JSON body. It's GraphQL, not REST, so you ask for exactly the fields and columns you want.

Token: a personal API token in the Authorization header. It can do what that user can do in monday, no more. Regenerating it kills the old one.

Profile picture Developers API token

Version: send API-Version: YYYY-MM. Without it you get whichever version is Current, and that changes every quarter.

The limits that end a monday.com sync early

COMPLEXITY_BUDGET_EXHAUSTED

How you'll know: Calls start failing after a burst, then work again a minute later.

Fix: Complexity is a points budget per minute: 10 million for personal tokens (1 million on trial and free accounts), 5 million per app token, and no single query over 5 million. Add complexity { query before after } to a request to see what it costs, page with next_items_page, and drop columns you don't read.

DAILY_LIMIT_EXCEEDED

How you'll know: The sync stops for the rest of the day, and it resets at midnight UTC.

Fix: Daily calls depend on plan: 200 on Free, 1,000 on Standard and Basic, 10,000 on Pro, 25,000 on Enterprise. On the lower plans, polling a board every few minutes uses the allowance up. Switch to webhooks and keep one catch-up run a day.

Minute and concurrency limits

How you'll know: "Minute limit rate exceeded" or "Concurrency limit exceeded" during a bulk load.

Fix: Queries per minute are 1,000 on most plans, 2,500 on Pro and 5,000 on Enterprise, and simultaneous requests 40, 100 and 250. Honor the Retry-After header and cap your worker pool.

A sync that broke and nobody changed it

How you'll know: A field that used to come back is missing or shaped differently after a quarter turns over.

Fix: The request had no API-Version header and the Current version moved. Pin a version, and test against each new release candidate before your pinned version reaches Maintenance.

Which query or mutation for which CRM job

Job Use Watch for
Read deals and their columns boards(ids:) { items_page(limit:) { cursor items { column_values } } } 25 items per page by default, 500 at most. Ask only for the columns you use, because every extra field raises complexity.
Read the next page next_items_page(cursor:) Pass the cursor at the root instead of nesting under boards, which costs less. You can't send a cursor and query_params together.
Find a contact by email or external ID items_page_by_column_values Match on a column you control, like an external ID, so a renamed contact still matches.
Create a lead or deal create_item(board_id:, item_name:, column_values:) column_values is a JSON string keyed by column ID, not by the title users see.
Update a deal stage or value change_multiple_column_values One call for several columns instead of one call per column.
Hear about changes create_webhook(board_id:, url:, event:) One board per webhook. See the webhook steps below.

Setting up a monday.com webhook for a CRM board

  1. 1

    Pick the narrowest event

    change_status_column_value or change_specific_column_value with a column ID in config fires only when the deal stage moves. change_column_value fires on every edit. Other events cover new items, moves between groups, archives and updates.

  2. 2

    Answer the challenge

    When you create the webhook, monday POSTs a JSON body with a challenge value. Your endpoint has to send the same JSON back, or the webhook isn't created.

  3. 3

    Verify app webhooks

    Webhooks created with an integration app's OAuth token carry a JWT in the Authorization header, signed with the app's Signing Secret.

  4. 4

    Plan for missed deliveries

    If your endpoint fails, monday retries once a minute for 30 minutes, then gives up. Make the handler idempotent and keep a daily reconciliation that compares board items with the other system.

What the API reaches, and what it doesn't

The API reads and writes boards, items, subitems, columns, updates and users. It doesn't create or edit automation recipes, so those stay in the board's automation center, covered on our monday.com automations page. For ready-made connectors before writing anything, see monday integrations.

n-frames builds the part between monday CRM boards and the systems that need the same facts: a won deal creating the invoice in accounting, a signed contract moving the deal stage, a bulk move of contacts from an old CRM into monday's boards with their custom fields intact.

Questions people ask

Does monday CRM have a REST API?

No. monday.com's API is GraphQL only, for monday CRM and every other monday product. Each request names the fields it wants, and you POST them all to one endpoint.

Where do I get a monday API key?

Click your profile picture, choose Developers, and open the API token section. That personal token is enough for internal work. An OAuth app only matters when you build something other accounts will install.

Is there an official Python SDK for the monday API?

Yes. monday publishes monday-api-python-sdk on PyPI, listed in its developer docs. It wraps common calls and still lets you send raw GraphQL for anything it doesn't cover.

Does monday CRM support webhooks?

Yes, per board, created through the API or from the board's integrations. You choose the event, such as an item created or a specific column changing, and monday POSTs to your URL.

What's the monday apps framework, and is it the same as the API?

They're related. The API is how outside code reads and writes monday data. The apps framework is for building views, widgets and integrations that run inside monday, which can be shared through its marketplace. Apps call the same API underneath.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.