ZenotiHelp

Configure integration field mapping

ZTZenoti Docs Team Updated June 26, 2026 2 min readHow-to

Field mapping controls how data from external platform forms (Meta or Google Ads) maps to lead fields in AI Lead Manager. Proper field mapping ensures that prospect information flows correctly into lead records when a lead is captured.

Before you begin

Permission: You must have access to the AI Lead Manager integrations area.

Steps

Map platform form fields to lead fields

  1. Navigate to Lead Management > AI Lead Manager > Platform Integration.
  2. Select the integration (Meta or Google Ads) you want to configure.
  3. Under the list of synced forms, select the form you want to map.
  4. The mapping page displays two columns:
  • Platform fields -- The fields defined on your advertising platform's lead form (for example, "Full Name", "Email Address", "Phone Number").
  • Lead fields -- The available target fields in AI Lead Manager (for example, Name, Email, Phone, Source, Type, Stage).
  1. For each platform field, select the corresponding lead field from the dropdown.
  2. Select Save to apply the mapping.

Mapping status

Each form tracks its mapping status:

Status Description
Unmapped No platform fields have been mapped to lead fields.
Partially Mapped Some platform fields have been mapped. Unmapped fields do not populate on captured leads.
Fully Mapped All platform fields have been mapped to lead fields.

Available target fields

Common target fields for mapping include:

Lead field Description
Name The lead's full name
Email The lead's email address
Phone The lead's phone number
Stage The initial pipeline stage for the lead
Source The lead source
Type The lead type classification
Priority The lead priority level
Center The center the lead is assigned to
Assignee The team member assigned to follow up on the lead

Set default field properties

After mapping fields, configure the default lead properties applied to every lead captured from this integration:

  1. From the integration details page, navigate to Field properties.
  2. Set default values for Lead stage, Source, Priority type, Lead type, Center, and Assignee.
  3. Select Save to apply the field properties.

These defaults are applied automatically to every lead captured from the integration, in addition to the field-to-field mappings configured above. The Assignee target field ensures every captured lead is assigned to a team member automatically.

Resync forms

If your platform forms have changed (new fields added, forms created or removed):

  1. Navigate to Lead Management > AI Lead Manager > Platform Integration and select the integration.
  2. Select Resync to refresh form and account data from the platform.
  3. Review any new forms and update field mappings as needed.
Was this article helpful?
Your feedback helps us improve our documentation.