Quickbase Integration

The Quickbase integration turns each new NZ Leads lead into a record in a Quickbase table you choose. You decide which Quickbase field receives each lead value, so the records land in your table the way your team already uses it.

Quickbase can also be your scheduler: the voice agent and AI text conversations can book appointments straight into your own Quickbase appointments table. See Book appointments in Quickbase.

ℹ️

You set the Quickbase integration up once and then choose which sources and voice agents use 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

You map each of these lead values to a field in your Quickbase table:

Values you don’t map are not sent.

Record updates

NZ Leads creates a new Quickbase record for each new lead. Later updates for the same lead, such as contact info being found, interest being confirmed, or a call finishing, update that same record instead of creating a duplicate.

Empty lead values are not sent, so an update never blanks data that is already in the record.

Connect Quickbase

Get a Quickbase user token

In Quickbase, click your name in the top right, open My Preferences, and click Manage my user tokens for your realm. Use an existing token or click + New user token. The token must be assigned to the Quickbase app that holds the table.

Add Quickbase

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 → Quickbase. For a voice agent, go to Voice Agents → Agents, click Edit on the agent, and use Add integration in its Integrations section. The Quickbase window opens. If your account already has a Quickbase integration, pick it on the Use existing tab instead.

Enter the table and token

Open the table in Quickbase and copy the link from the browser address bar, then paste it into Table link or table ID. NZ Leads fills in Realm from the link. You can instead enter the table ID and type the realm hostname (for example yourcompany.quickbase.com) into Realm. Then paste your Quickbase user token into User token.

Load and map the fields

Click Load fields. NZ Leads reads the fields of your table. Under Map lead values to Quickbase fields, pick the Quickbase field for each lead value, or leave Don’t sync. On the first load, fields with matching names, such as a field called Phone or Email, are picked for you. You can change every pick.

Formula, lookup, and summary fields and Quickbase’s built-in fields, such as Record ID, can’t be written, so they aren’t listed. Map every field your table requires, or Quickbase rejects the new record. The card warns about required fields you haven’t mapped.

Save and enable

Click Save (at least one value must be mapped). The card then shows Quickbase Integration: turn Enabled on. Leads only start syncing after the integration is enabled.

Choose where it’s used

Quickbase added from a source’s or a voice agent’s Integrations tab is already on there, unless that place already uses another Quickbase integration. To use it in more places, tick them under Where it’s used in the Quickbase window, then click Done.

To add this Quickbase integration to another source or voice agent later, open its Integrations tab → Add integration → Use existing and pick it. Each place sends to one Quickbase 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 Quickbase 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 → Quickbase 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.

To change the setup later, open the Quickbase window, click Load fields to edit the mapping under Update Quickbase Configuration, change what you need, and click Save. To remove the setup, expand the row with your realm and table on the card, click the delete icon, then Yes.

Lead filters

These options control when NZ Leads sends a lead to Quickbase:

Turning Quickbase off

Records already in your table stay there.

Troubleshooting

ℹ️

When Quickbase rejects something, such as an invalid token or a field that rejects a value, a warning icon appears at the top of the Quickbase card and the integration shows Has errors in your integrations list. Click the icon to read the errors from the last 7 days.

Book appointments in Quickbase

The voice agent and AI text conversations can check open times in your Quickbase appointments table and book new appointments straight into it.

The scheduler is set up separately from the Quickbase integration above, with its own table link and user token.

Where to set it up

Connect the appointments table

Open your appointments table in Quickbase and copy the link from the address bar. Paste it as the Appointments table link. If you enter a table ID instead of a link, a Realm field appears for the realm hostname.

Paste a user token

Create a user token under your name → My Preferences → Manage my user tokens, and assign it to the Quickbase app that holds the appointments table. Paste it as the User token.

Click Connect

Click Connect. NZ Leads reads the fields of your table and picks them automatically:

  • Appointment start - a Date / Time field, or a Date field plus a Start time field (Time of Day).
  • Appointment end (a Date / Time field) or Appointment length field (a Duration field, or a Numeric field in minutes). The end wins when both are set.
  • Status field.
  • The customer details fields, such as name, phone, email, address, and notes.

A short summary shows what was picked. Click Edit to change any of it.

Set the appointment length and working hours

  • Appointment length (minutes) - default 60. Used for new bookings, and for existing appointments that have no end or length.
  • Working Hours - new setups start with weekdays, 8:00 AM to 5:00 PM, in the business timezone. Change them to match your business.

Open times are your working hours minus the appointments already in the table.

Advanced options

All of these are in the Advanced panel and are optional:

Test the connection

How booking works

ℹ️

An appointment that has a date but no time blocks that whole day.


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

Get Started