Monday.com Integration
Sync Coeffection records to Monday.com boards in real time. Maps your entity fields (custom and standard) to Monday columns, auto-creates boards for new entity types, resolves edit conflicts deterministically, and writes a sync-history log per record so you can trace every change.
Prerequisites#
- Monday.com account on a plan that allows API access (Standard plan and above).
- A Monday workspace you have admin access to (so Coeffection can create and update boards).
- Coeffection role with
integrations:managepermission.
Connecting Monday.com#
- Go to Admin Settings → Integrations → Monday.com.
- Click “Connect Monday.com”.
- Sign in with the Monday account that has admin access to your target workspace.
- Approve Coeffection's requested scopes (read/write boards, items, updates, and webhooks).
- Pick the workspace where Coeffection should sync.
Board mappings#
Each entity type (Contact, Lead, Opportunity, custom entity) can sync to one Monday board. Coeffection's Board Mappings editor lets you:
- Pick an existing Monday board, OR let Coeffection auto-create one.
- Map Coeffection fields to Monday columns column-by-column (text, number, date, status, person, link, dropdown — all supported).
- Choose which Coeffection pipeline stage maps to which Monday group/status.
- Set sync direction per field: Coeffection → Monday only, Monday → Coeffection only, or two-way.
Auto-board creation#
Click “Create board automatically” in the Board Mappings editor and Coeffection will:
- Create a new Monday board in your chosen workspace named after the entity type (e.g., “Coeffection — Opportunities”).
- Add columns matching every Coeffection field on that entity (custom and standard), with appropriate Monday column types.
- Add status groups matching your Coeffection pipeline stages.
- Register a webhook so Monday changes flow back into Coeffection.
- Backfill all existing entity records as Monday items on the next sync cycle.
Sync history#
Every sync attempt — successful or failed — appears in the Sync History view (Admin Settings → Integrations → Monday.com → Sync History). For each event you can see:
- Which record was synced and in which direction
- Which fields changed (before/after values)
- If the sync failed: the Monday API error message and a “Retry” button
- Timestamp and triggering user/event
Conflict resolution#
If a record is edited in both Coeffection and Monday between sync cycles, the conflict resolver applies these rules in order:
- Most recent timestamp wins per field. If a field was edited at 14:02 in Coeffection and 14:05 in Monday, the Monday value wins for that field only — other fields are unaffected.
- Explicit per-field direction overrides timestamps.If you set “Coeffection → Monday only” for a field, the Coeffection value always wins regardless of timestamps.
- Locked fields never sync.Set a field to “Do not sync” in the mapping editor to fully isolate it.
Contact matching (existing boards)#
When connecting an existing Monday board (not auto-created), Coeffection matches existing Monday items to Coeffection records by:
- Exact email match (highest confidence)
- Exact phone match
- Exact name match within the same Monday group
- Fuzzy name match (≥85% similarity) — flagged for review in Sync History before applying
Troubleshooting#
Sync stopped working
Most common cause: the Monday admin who connected the integration left the workspace, revoking the OAuth token. Reconnect from Admin Settings → Integrations → Monday.com using a current admin's account.
Records duplicated in Monday after a backfill
Contact matching missed an existing Monday item (often because email/phone was blank on the original record). Use Monday's built-in duplicate finder, then in Coeffection set the matched record's “Monday Item ID” field to the canonical one.
Status column doesn't match my pipeline stages
Edit the board mapping's pipeline-stage mapping. You can map multiple Coeffection stages to one Monday status label (collapse) or split one Coeffection stage to multiple Monday labels (fork) — both are supported.