Theme
Open the portal

monday CRM

Connect monday once and the customers who connect to your service arrive as contacts that keep themselves current. Nothing to configure, no field mapping to set up by hand — and nothing is ever written to a board you already had.

New to the shared model? Start with the CRM integrations overview — what syncs, what never does, and how consent works.

Before you start

Step 1 — connect your allus account

In the allus portal, open Configuration → Integrations and click Connect next to monday CRM. The portal does the allus half by itself: it creates a service for you (alerts go to your allus account's own email), publishes its request fields (first name, last name, email, phone, address), registers its own data client and its webhook — then hands you to this integration's own setup page for step 2.

The integration holds the service key on your behalf. It creates the service's key pair at that moment and keeps the private half encrypted — that is what lets it read what your customers share. The key is never shown in your allus portal.

You can add more request fields in the portal at any time. The integration never removes or rewrites a row you added; each one simply shows up in monday as its own column.

Step 2 — authorize monday

Press Connect monday CRM. You are sent to monday's own authorization screen, over OAuth 2.1 with PKCE. The integration asks for:

ScopeWhy
me:read, account:readTo know which monday account it is connected to — that is how an uninstall is matched back to your connection.
boards:read, boards:writeTo create its own board and columns, and to write contacts onto them.
updates:read, updates:writeTo post a note on a contact when a field is withdrawn or a connection ends — and to check it has not already posted the same one.

Approving sends you back to the integration's status page. That is the whole setup.

What it creates in monday

The integration works on one board of its own, called allme contacts in the language you connected in. It is created on the first connection and is the only board the integration ever touches.

Rename them freely. Columns are matched by a hidden marker in their description, never by their title, so renaming a column or the board itself changes nothing. Deleting a column means the integration creates it again the next time that field changes; deleting the board means it creates a fresh one on your next reconnect — it will not adopt another board of yours.

Every column is a plain text column. monday's typed columns want a second value the integration does not have — a country code alongside a phone number, coordinates for a location — and inventing one would put a plausible but wrong value on your record. A phone number is stored in international + form where the customer provided one; an address is written as one line.

What lands where

What happensWhat you see in monday
A customer connects to your serviceA new item appears with everything they shared, usually within seconds.
They edit a synced fieldThat one column updates. Nothing else is touched.
They withdraw a fieldThe column is emptied and an update is posted on the item saying which field was withdrawn.
They end the connectionAn update is posted saying the connection ended. The item is never deleted or blanked — the data you were given stays yours.
They share a photo or a documentNothing. Document contents never enter a CRM.

How a customer is matched to an item

On the first contact the integration looks for an existing item on its board before creating one: by allme ID, then by email, then by an international phone number. A search that finds more than one candidate is treated as no match — a duplicate item is easy to merge, while writing one person's details onto another's is not.

Matching is scoped to the integration's own board. monday keeps contacts on boards rather than in one account-wide list, so the integration cannot look for a customer among items it did not create. A customer you already have on your own boards therefore gets a new item here rather than being merged into that one. Selecting an existing board is not part of this version.

Documents and signed flows

A document your customer signs, or a contract flow they complete, shows up as an update on their item's timeline — the same object regular notes use, so nothing new to look for. Each update names the document (or the flow) and the date, and a document that later changes status — signed, accepted, cancelled — gets a follow-up update saying so, including how it was signed when that applies.

This needs no setup on your side: it activates automatically once your integration is fully connected.

Rate limits

The API allowance the integration spends is your monday plan's, and lower plans allow on the order of a thousand calls a day. Two things keep it modest: only changed fields are written — never a whole record refresh — and each run applies at most a small batch, spaced out, leaving the rest to the next run a few minutes later. If monday asks the integration to slow down it waits for exactly as long as monday asks and loses nothing.

Uninstalling

monday tells the integration when you uninstall its app — it is the only CRM here that does. When that happens:

  1. Syncing stops immediately and the monday credentials are discarded.
  2. Everything the integration holds for you is deleted within seven days, comfortably inside the ten monday's marketplace terms allow. Reconnect inside that window and nothing is lost.
  3. Your monday board and its items stay exactly as they are. The purge removes the integration's own records, never anything in your account.

Your allus service is not removed by an uninstall, because the integration cannot act on your allus account without your credentials. Use Disconnect on the integration's status page for a clean teardown of both sides, or delete the service in your portal.

If something looks wrong

The integration's status page carries a sync health card: one row per customer whose data it currently cannot apply, with the repair. Rows clear themselves as soon as that customer syncs again, so an empty card means everything is flowing.

What it saysWhat to do
The CRM refused our accessReconnect monday from the status page — the app's access was revoked or expired.
We lost track of the CRM recordReconnect; the stored item reference is no longer usable.
The CRM refused the changeOpen the item in monday and check the column it names.

Next

CRM integrations overview · How the connection model works · Account clients · Webhooks