ZenotiHelp

Gift card webhook events

ZTZenoti Docs Team Updated August 21, 2026 4 min readGuide

Configure webhook events and email notifications for gift card transactions in your organization.


On this page


Before you begin

  • You need the following permissions:

Permission: View (under Gift Cards) β€” Required to access gift card webhook settings.

Permission: Edit (under Gift Cards) β€” Required to modify webhook and notification configurations.

  • Your organization must have webhook endpoints configured to receive gift card events.
  • Email templates must be set up if you want to send gift card notifications to recipients.

Steps

Configure gift card webhook events

  1. Navigate to Configuration > Organization > Webhooks.
  2. In the Gift Card Events section, enable the events you want to track:
  • Guest.GiftCard.Created β€” Triggers when a gift card is successfully purchased
  • Guest.GiftCard.Updated β€” Triggers when gift card details change (balance updates, status changes, expiry extensions)
  1. For each enabled event, configure the following:
  • Endpoint URL β€” Enter the URL where webhook payloads should be sent
  • Authentication β€” Select the authentication method (if required)
  • Retry Settings β€” Configure retry attempts for failed webhook deliveries
  1. Click Test Connection to verify your webhook endpoints are reachable.
  2. Click Save.

Set up gift card email notifications

  1. Navigate to Configuration > Organization > Email Templates.
  2. In the Gift Cards section, configure templates for:
  • Gift Card Purchase Confirmation β€” Sent to the purchaser after successful payment
  • Gift Card Delivery β€” Sent to the recipient with gift card details
  • Gift Card Balance Update β€” Sent when gift card balance changes
  1. For each template, customize:
  • Subject Line β€” Enter the email subject
  • Message Body β€” Design the email content using available merge fields
  • Sender Information β€” Configure the "from" name and email address
  1. Use merge fields to personalize emails:
  • {GiftCardNumber} β€” The gift card number
  • {FaceValue} β€” The gift card's face value
  • {Balance} β€” Current gift card balance
  • {RecipientName} β€” Gift card recipient's name
  • {PurchaserName} β€” Gift card purchaser's name
  • {ExpiryDate} β€” Gift card expiration date
  1. Click Preview to test how the email will appear.
  2. Click Save.

Configure notification triggers

  1. Navigate to Configuration > Organization > Gift Card Settings.
  2. In the Notifications section, enable automatic email sending for:
  • Send email on purchase β€” Automatically email gift card details to recipients
  • Send email on balance update β€” Notify recipients when their gift card balance changes
  • Send email on expiry reminder β€” Send reminder emails before gift cards expire
  1. Set timing preferences:
  • Delivery delay β€” How long to wait before sending recipient emails (immediate or delayed)
  • Reminder schedule β€” When to send expiry reminders (7 days, 14 days, or 30 days before expiration)
  1. Click Save.

Gift card notification templates

Zenoti provides three built-in email notification templates for gift card operations. Each template supports macros that are automatically replaced with actual values when the notification is sent.

Gift Card POS Notification

This email is triggered when a gift card is purchased and the invoice is closed at the Point of Sale.

To configure this template:

  1. Navigate to Configuration > Organization > Email Templates.

  2. Select Gift Card POS Notification from the template list.

  3. Customize the template using the following available macros:

    Macro Description
    [CenterCity] Center city
    [CenterCountry] Center country
    [CenterAddress] Center street address
    [CenterZip] Center ZIP/postal code
    [OrgName] Organization name
    [CenterPhone] Center primary phone
    [CenterPhone2] Center secondary phone
    [CenterAddlData1] Center additional data field
    [CenterName] Center name
    [CenterE-mail] Center email address
    [SenderName] Name of the person who sent the gift card
    [Value] Gift card face value
    [Card #] Gift card number
    [Expiry] Gift card expiry date
    [TreatmentList] List of redeemable services (for service-based cards)
    [GiftCardMessage] Personalization message from sender
    [GiftCardLabel] Custom gift card label (if configured)
    [GiftCardName] Gift card template name
    [GuestReferralCode] Guest referral code

Bonus Gift Card Email

This email is sent when a bonus gift card is issued alongside a regular gift card purchase.

To configure this template:

  1. Navigate to Configuration > Organization > Email Templates.

  2. Select Bonus Gift Card Email from the template list.

  3. Customize the template using the following available macros:

    Macro Description
    [BonusGiftCardName] Bonus gift card template name
    [BonusGiftCardCode] Bonus gift card code
    [Card #] Gift card number
    [Value] Gift card face value
    [Currency] Currency symbol/code
    [ActivationDate] Activation date
    [ExpirationDate] Expiration date
    [Expiry] Expiry date (alternate format)
    [TreatmentList] List of redeemable services
    [RedemptionCenter] Center where card can be redeemed
    [GiftCardLabel] Custom gift card label
    [Logo] Organization logo
    [TemplateImage] Gift card template image
    [claimLink] Link for recipient to claim the gift card
    [CustomMacro1] Custom configurable macro

Gift Credit on Membership Cancellation

This notification is triggered when a membership is cancelled and gift credit is issued to the guest.

To configure this template:

  1. Navigate to Configuration > Organization > Email Templates.

  2. Select Gift Credit on Membership Cancellation from the template list.

  3. Customize the template using the following available macros:

    Macro Description
    [OrgName] Organization name
    [CenterName] Center name
    [CenterCity] Center city
    [CenterAddress] Center address
    [CenterCountry] Center country
    [CenterState] Center state
    [CenterZip] Center ZIP code
    [CenterPhone] Center phone
    [CenterPhone2] Center secondary phone
    [CenterAddlData1] Center additional data
    [CenterE-mail] Center email
    [MembershipName] Name of the cancelled membership
    [MembershipStartDate] Membership start date
    [MembershipExpiryDate] Membership expiry date
    [MembershipAvailableTillDate] Membership available-till date
    [GiftCreditValue] Gift credit value issued
    [GiftCreditExpiry] Gift credit expiry date
    [GiftCredit#] Gift credit card number
    [ListOfRedeemableServices] Services redeemable with the gift credit
    [GuestReferralCode] Guest referral code
    [DownloadLink] Download link
    [MailUnsubscribeLink] Email unsubscribe link

Settings reference

Setting Description Default
Guest.GiftCard.Created webhook Triggers when a gift card is successfully purchased through any channel Disabled
Guest.GiftCard.Updated webhook Triggers when gift card balance, status, or expiry date changes Disabled
Send email on purchase Automatically sends gift card details to the recipient after purchase Enabled
Send email on balance update Sends notification when gift card balance changes due to redemption or adjustment Disabled
Delivery delay Time delay before sending recipient notification emails Immediate
Expiry reminder emails Sends reminder emails before gift cards expire Disabled
Reminder schedule Number of days before expiry to send reminder emails 7 days
Was this article helpful?
Your feedback helps us improve our documentation.