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:

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.

Create only new leads

Label: Create only new leads. Default: off.

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.

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

Items already on your Monday board are untouched.

Troubleshooting


Questions about the Monday.com integration? Email support@nzleads.com.

Get Started