ZenotiHelp

Guest linking (zenoti core)

ZTZenoti Docs Team Updated June 26, 2026 4 min readGuide

Guest linking connects your AI Lead Manager leads to Zenoti Core guest records, giving your team a complete view of each lead's history β€” past appointments, purchases, membership status, and loyalty points β€” without switching between modules. This enables more personalized follow-ups and allows staff to view transaction history, apply memberships, process payments, and manage invoices directly from the lead record.

Before you begin

  • Your organization must have AI Lead Manager enabled.
  • Leads must exist in the system with valid email addresses or phone numbers.
  • Manual guest linking and the Change action are two independent one-time operations per lead. Using one does not consume the other β€” even after the initial manual link, the Change button remains available for a one-time re-link. Plan carefully before linking.
  • You need the following permissions:

Permission: Edit (on the My Leads or All Leads permissions) β€” Required to manage lead records and their guest linking status.

How automatic guest linking works

AI Lead Manager automatically links leads to Zenoti Core guest records through a background process. The system uses a multi-step matching process:

  1. Check existing links β€” The system first looks for other leads in your organization that share the same email address or phone number and are already linked to a Zenoti guest. If exactly one match is found, the system copies the existing link. If multiple leads share the same linked guest, the system reuses that link.

  2. Search Zenoti Core β€” If no existing link is found, the system searches your Zenoti Core guest database using the lead's email address and phone number (minimum 3 characters each).

  3. Create new guest β€” If no match is found, Zenoti automatically creates a new guest profile in Zenoti Core using the lead's name and contact information, and links it to the lead. No manual step is required for this fallback.

After guest linking completes, the system automatically resumes processing any pending activities or events for the lead (such as queued emails, notifications, or workflow steps).

What you see after guest linking

Once a lead is linked to a Zenoti Core guest, the lead's Details tab displays the following sections:

  • Linked guest profile β€” A blue banner at the top of the Details tab showing the linked guest's name and code.
  • User details β€” The lead's contact information and profile data.
  • Lead assessment β€” Lead scoring, stage, source, type, and priority information.
  • Pricing and transaction β€” Transaction-related data for the lead.
  • Follow-ups β€” Upcoming follow-up activities and appointments.
  • Additional lead details β€” Custom fields from the Master form configured for your organization.

Quick actions on linked leads

When a guest is linked, two quick actions become available on the lead detail page:

  • View Point of Sale (PoS) β€” Opens the POS screen pre-populated with the linked guest's profile, so staff can immediately process transactions.
  • Book appointment β€” Opens the Booking Wizard with the guest's membership alerts and due amounts visible, enabling informed scheduling.

In some cases, you may need to manually specify which Zenoti Core guest a lead should be linked to:

  1. Open a lead from the All Leads page.
  2. Go to the Details tab.
  3. Click the Link to guest panel.
  4. Search for the appropriate Zenoti Core guest record by name, email, or phone.
  5. Select the guest and click Link guest to confirm.

Important: Manual guest linking can only be performed once per lead. After you manually link a lead to a guest, the system sets a flag that prevents further manual changes.

Change a linked guest

If a lead was linked to the wrong guest (whether automatically or manually), you can use the one-time re-link option:

  1. Open the lead from the All Leads page.
  2. Go to the Details tab.
  3. Click the Change button next to the linked guest profile banner. If a guest linking error occurred, the button displays as Update instead of Change β€” this signals an error state that you should resolve by re-linking to the correct guest.
  4. A Change linked guest confirmation dialog appears: "You can perform this action only once, Once done it can not be reverted back. Do you wish to continue?"
  5. Click Proceed to continue (or Cancel to go back).
  6. The Link to guest panel opens β€” search for and select the correct guest, then click Link guest.

Important: The Change (or Update) button allows one re-link only. After you change the linked guest, no further manual changes are possible.

Create a new guest profile from a lead

When no matching guest exists in Zenoti Core and you want to create one manually:

  1. Open the lead from the All Leads page.
  2. Go to the Details tab.
  3. Click Create a guest profile.
  4. The Create Guest form opens with the lead's email pre-filled.
  5. Complete the guest details and click Create guest and launch POS.

Note: The system creates the guest record in Zenoti Core and immediately opens the POS screen with the new guest's profile loaded.

Handle leads with minimal contact information

For leads with incomplete contact information (email addresses or phone numbers shorter than 3 characters), the system skips the Zenoti Core search step and attempts to create a new guest record directly. To improve linking accuracy, ensure your lead capture forms collect complete contact information.

Tips

  • Ensure complete contact information β€” Leads with full email addresses and phone numbers (at least 3 characters each) have the highest success rate for automatic guest linking.

  • Review failed links β€” If guest linking fails for a lead, check that the contact information is valid and consider using the manual linking or guest creation flow.

  • Monitor new guest creation β€” When the system creates new guest records automatically, review them periodically to ensure accuracy and completeness.

  • Use quick actions β€” After linking, take advantage of "View Point of Sale (PoS)" and "Book appointment" to work with the guest directly from the lead record.

Was this article helpful?
Your feedback helps us improve our documentation.