ZenotiHelp

Membership webhook events

ZTZenoti Docs Team Updated September 12, 2026 1 min readGuide

Configure webhook events to receive real-time notifications when membership lifecycle changes occur in your organization.

Note: For conceptual background on how webhooks integrate with membership workflows, see Memberships Overview.

Before you begin

  • You need the Manage Webhooks permission to configure webhook events.
  • Your organization must have webhook endpoints configured to receive event notifications.
  • Ensure your webhook endpoint can handle the membership event payload structure.

Steps

Configure membership webhook events

  1. Navigate to Configuration > Webhook Settings.

  2. In the Event Types section, locate the Memberships category.

  3. Select the membership lifecycle events you want to monitor:

  • Membership Created β€” Fires when a new membership is enrolled
  • Membership Updated β€” Fires when membership details are modified
  • Membership Cancelled β€” Fires when a membership is cancelled
  • Membership Frozen β€” Fires when a membership is frozen
  • Membership Unfrozen β€” Fires when a frozen membership is reactivated
  • Membership Renewed β€” Fires when a membership auto-renews or is manually renewed
  • Membership Transferred β€” Fires when a membership is transferred between guests
  • Collection Processed β€” Fires when a recurring membership collection is completed
  • Collection Failed β€” Fires when a recurring membership collection fails
  1. For each selected event, configure the following settings:
  • Endpoint URL β€” Enter the webhook endpoint that will receive the event notification
  • Authentication β€” Select the authentication method (None, Basic Auth, or Bearer Token)
  • Retry Policy β€” Choose how many times to retry failed webhook deliveries
  • Timeout β€” Set the maximum time to wait for a response from your endpoint
  1. Click Test Webhook to verify your endpoint can receive and process the event payload.

  2. Click Save to activate the webhook events.

Verify webhook event delivery

  1. Navigate to Configuration > Webhook Logs.

  2. Filter the logs by Event Type and select Memberships.

  3. Review the delivery status for recent membership events:

  • Success β€” Event was delivered successfully
  • Failed β€” Event delivery failed (check error details)
  • Retrying β€” Event is being retried based on your retry policy
  1. Click on any log entry to view the complete event payload and response details.
Was this article helpful?
Your feedback helps us improve our documentation.