What we do
Tools
Industries
Department
How we workLet's talk →
Home/Monday CRM
monday CRM

The monday CRM API, and How a Deal Stays Joined to Its Contacts

Open a deal in monday CRM and its contact, company and value sit side by side. Ask the API for the same deal and the contact column comes back null. Nothing's broken. monday CRM runs on the monday.com GraphQL API, and the columns that join one CRM record to another follow their own rules there.

Where Monday CRM stops

It runs your pipeline, but it can't see the sales data that lives in accounting, support and everything outside monday.com.

Stuck on Monday CRM? Let's solve it →
monday CRM API, short version

Which API: there's no separate CRM API. monday CRM uses the monday.com GraphQL API at https://api.monday.com/v2, the same one behind every board.

Records: leads, contacts, accounts and deals are items on boards, and every field on them is a column you read through column_values.

Links: a deal points at its contact, and a contact at its account, through connect boards columns. Fields shown from the linked record are mirror columns.

The rest: tokens, the API-Version header, complexity and daily limits, and webhooks are on our monday.com API page for CRM boards.

Linked CRM columns in the monday API, read and write

Column on the CRM board Reading it Writing it
Connect boards (deal to contact, contact to account) Use an inline fragment: ... on BoardRelationValue { linked_item_ids linked_items { id name } display_value }. Its text and value always return null. change_multiple_column_values with {"connect_boards": {"item_ids": [123, 456]}}. Passing null clears it. change_simple_column_value isn't supported here.
Mirror (the contact's email shown on the deal) ... on MirrorValue { display_value mirrored_items { ... } }. display_value is the text summary, and mirrored_items gives each linked item with its typed value. Can't be updated or cleared. Write to the column on the source item, such as the email on the contact, and the deal shows the new value.
Every deal for one account Filter the deals board in items_page with query_params on the connect boards column, using any_of and the account's item ID. Nothing to write. Moving a deal to another account means setting its item_ids again.
A new board to link to Connected when the column is set up, on the board or through create_column, which can also add a matching column on the other board for a two-way link. An item mutation can't connect a new board. The connection has to exist before the API can link items across it.

How a monday CRM sync loses the deal-to-contact link

The contact column looks empty

How you'll know: text and value are null on a deal that clearly has a contact in the board view.

Fix: They're always null on connect boards and mirror columns. Ask for linked_item_ids through the BoardRelationValue fragment, or display_value if names are enough.

A write to the deal's email field errors

How you'll know: The mutation fails on a column that shows the contact's email.

Fix: It's a mirror column, and mirror values are read-only. Update the email column on the contact item instead.

Imported deals arrive without their people

How you'll know: After a move from an old CRM, deals have names and values but no contact or account attached.

Fix: Load accounts first, then contacts linked to account item IDs, then deals linked to both. Keep a table from each old record ID to its new monday item ID so every link resolves.

Linked-item queries that cost too much

How you'll know: Asking for linked_items with many fields on every deal burns through the complexity budget.

Fix: Pull only linked_item_ids with the deals, then fetch those contacts in one separate items(ids: [...]) query with just the fields you need.

When monday CRM data has to leave monday

monday CRM's own integrations take in email, calendars, Slack, Zoom, DocuSign and QuickBooks, and its automations handle a lot inside the boards. The API comes in when the next system isn't on that list, or when the record has to travel with everything linked to it.

A residential real estate team is a fair example. An agent moves a deal to under contract, and the transaction coordination software needs the same property, buyer, seller and price, with the commission split worked out from the deal's columns. On the API, that's one deal plus its linked contacts, sent across once instead of typed twice.

n-frames builds those handoffs on the monday CRM API: lead intake from forms and other tools onto the right board, deals carried out with their contacts and account intact, and reports that put the pipeline beside closings, orders or support data.

monday CRM, plans and rivals

Is monday.com a CRM, or is monday CRM separate?

monday.com is a work management platform, and monday CRM is its dedicated sales product, with boards set up for leads, contacts, accounts and deals. Both sit on the same platform and the same API, so a developer works with monday CRM data exactly as with any other board.

How much does monday CRM cost?

monday CRM is priced per seat on monthly or annual plans, with higher tiers adding more automations and integrations. Current prices are on monday.com. The plan also sets your daily API allowance, so a busy integration can push you toward a higher tier.

Is there a free plan for monday CRM?

monday.com runs trials of its paid plans, and what its free tier includes changes, so check the pricing page before you count on it. A free account also gets a far smaller API allowance, 200 calls a day, which won't carry a real sync.

monday CRM vs HubSpot, which is better?

It turns on how your team works. monday CRM keeps sales on the same visual boards as the rest of monday.com. HubSpot is a more conventional CRM with a bigger built-in marketing suite. For integration work the APIs differ too: monday is GraphQL over boards and columns, HubSpot is REST over objects and associations, covered on our HubSpot API page.

monday CRM vs Salesforce, which should I use?

They're built for different depths. Salesforce scales into enterprise processes that monday CRM doesn't try to match, and monday CRM is quicker to set up for teams that don't need that. Decide on how complex your sales process really is, then check that the other systems you run can reach it.

Where do I log into monday CRM?

Through monday.com, with the same login as the rest of the platform when your account has CRM turned on.

Who builds integrations on the monday CRM API?

n-frames builds them for sales teams on monday CRM, from lead intake onto the right board to deals sent into accounting, transaction or project systems with their linked contacts and account attached.

Let's talk

A deal is won, and the next system already has it

n-frames builds the monday CRM API handoff that carries a deal, its linked contacts and its values into the accounting, project or transaction software that works it next, so nobody types it in again.

Deal details, entered once →

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.