Monday.com
The Monday.com integration creates an item on a Monday.com board every time a new lead comes through NZ Leads. You choose which board to use, which group within the board to drop new items into, and how each NZ Leads field maps to a Monday column - so your team’s board stays organized exactly how you already use it.
You set Monday.com up once and then choose where it’s used: which businesses, sources, and voice agents send leads to it. Add it from a source’s Messaging Settings → Integrations tab, or from Settings → Integrations in the menu, which lists all your integrations.
What gets synced
Every lead pushed into Monday.com creates one item. The item is named after the customer (“New Lead” when the name isn’t known yet). These NZ Leads fields can be mapped to columns:
- Email - the lead’s email
- Phone - the lead’s phone number
- Notes - the customer’s first message
- Zip - the lead’s postal code
- Location - the source’s name
- Source - the platform the lead came from, for example
YELP
Only mapped fields are written (see Field mapping).
Connecting Monday.com
Add Monday.com
In NZ Leads, open the source → Messaging Settings → Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Then click Add integration → Create new → Monday.com. The Monday.com window opens. If your account already has a Monday.com integration, pick it on the Use existing tab instead.
Step 1: Add API token
Generate a personal API token in Monday.com (Administration → Connections → Personal API token), paste it into Enter your API token and click Validate. When the token works, your workspaces load.
Step 2: Select Workspace
Choose the workspace under Choose a Monday.com Workspace.
Step 3: Select Board
Choose the board where new leads should appear under Choose a Monday.com Board. There is no default board; you always pick one.
Step 4: Select Group
Choose the group on that board under Choose a Group from this Board. New items from NZ Leads are created in this group.
Step 5: Map Fields
Next to each of NZ Leads’s fields (Email, Phone, Notes, Zip, Location, Source), pick a column under Select Monday Column. Only columns of type Text, Large Text, Numbers, Phone and Email can be mapped. You don’t have to map every field. Optionally add Custom JSON Data (see below), then click Save Configuration. Reset clears the choices on the card so you can start over.
Turn on the Enabled toggle
The card now shows Monday.com Integration with the Enabled switch off. Nothing is sent to Monday.com until Enabled is on.
Choose where it’s used
Monday.com added from a source’s Integrations tab is already on for that source, unless the source already uses another Monday.com integration. To use it for other sources, tick them under Where it’s used in the Monday.com window, then click Done.
To add this Monday.com integration to another source later, open that source’s Integrations tab → Add integration → Use existing and pick it. A source sends to one Monday.com integration at a time: turning on another one there replaces the current one after you confirm. Ticking a business under Where it’s used turns Monday.com on for that business’s sources, including future ones. Sources follow their business unless they choose differently on their own Integrations tab.
In Settings → Integrations, Add integration → Monday.com adds the integration to the business selected in the sidebar and opens its window. Tick the places that should use it under Where it’s used.
Options
Enabled
Turns this Monday.com integration on or off everywhere it’s used. It’s off after you save the configuration. To stop sending one source’s leads only, switch Monday.com off on that source’s Integrations tab instead.
Board
Which Monday.com board new items are created on. You pick it in the setup steps; there is no default.
Group
Which group within the selected board new items land in. You can reorganize the items on Monday after they’re created - changes to the group after the fact don’t affect NZ Leads.
Field mapping
Customize which Monday column each NZ Leads field writes to. If you don’t map a field, that field simply isn’t written to Monday - nothing else on the item is affected. When a lead is sent again later (for example when contact info arrives), the same item is updated using your current mapping.
Custom JSON Data
Optional. Adds fixed values for columns that need special formatting, such as dropdown columns. Each key is a Monday column ID and each value is that column’s value written as a JSON string, as in the example on the card. These values are added to every item.
Create lead in CRM only when contact info is received
Label: Create lead in CRM only when contact info is received. Default: off.
- When on - Monday.com gets the lead only once the lead has shared a phone number or email, and only if CRMs is checked under Trigger integrations: in the source’s Contact Info tab for that kind of contact info.
- When off - Monday.com gets the lead as soon as the lead first reaches out, even before you have their contact info.
Create only new leads
Label: Create only new leads. Default: off.
- When on - If your business had already messaged the lead before NZ Leads first received the conversation, the lead’s contact info is not sent to Monday.com. New messages in a conversation don’t send the lead again either.
- When off - Those leads and messages are sent too.
This option looks at the conversation, not at Monday.com: it doesn’t search Monday.com for an existing record.
Notify this integration only after the AI determines the lead is interested
Label: Notify this integration only after the AI determines the lead is interested. Default: off.
- Turning it on asks you to confirm with Enable.
- Monday.com then gets a lead only once the AI confirms the lead is interested, and again with each new message after that.
- It applies to every place that uses this Monday.com integration. Sources without an AI conversation (AI Assistant with Short or Long conversation in Conversation Setup) send no leads to Monday.com while it’s on.
- Can’t be turned on together with Create lead in CRM only when contact info is received or Create only new leads.
Press to validate API token
Expand the saved token on the card and click it to re-test your API token.
Removing the token
Expand the saved token, click the delete icon, then Yes. This removes the API token, the board selection, the group, and the field mapping. Monday.com gets nothing until you set it up again. The integration stays where it’s used.
To change the board, group, or mapping, remove the token this way and go through the steps again.
Matching and deduplication
NZ Leads remembers the Monday.com item it created for each lead and updates that item on later events instead of creating another one. It does not search your board for existing items. If you delete the item in Monday.com, NZ Leads doesn’t create it again.
Turning Monday.com off
- For one source - untick the source under Where it’s used in the Monday.com window, or switch Monday.com off on that source’s Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Other sources keep sending.
- Everywhere - turn off Enabled on the Monday.com card, or click Delete integration in the Monday.com window. Every source that used it stops sending to Monday.com.
Items already on your Monday board are untouched.
Troubleshooting
- “Failed to validate API token and get workspaces” - The API token is wrong or was revoked. Generate a new one in Monday.com.
- Board dropdown is empty - The workspace you picked has no active boards that the token’s user can see. Pick another workspace, or generate a token scoped to a user who can see the board.
- A column isn’t in the list - Only Text, Large Text, Numbers, Phone, and Email columns can be mapped.
- “Not set up yet” next to Monday.com on a source’s Integrations tab - Enabled is off. Click Settings and turn it on.
- Items going to the wrong place - The board and group are set when you save the configuration. To change them, remove the token and set Monday.com up again.
- Fields not populating on the item - That field isn’t mapped, or NZ Leads has no value for it yet. To change the mapping, remove the token and set Monday.com up again.
- A warning icon at the top of the card - Monday.com refused an item or an update, or the board can’t be found any more. The integration shows Has errors in your integrations list. Click the icon to read the errors from the last 7 days, and Clear Errors once you’ve fixed the cause.
- Duplicates - Each NZ Leads lead gets its own item, and leads without contact info still create items; consider turning on Create lead in CRM only when contact info is received.
Questions about the Monday.com integration? Email support@nzleads.com.