Webhooks

Contact Event Subscriptions

Choose which workspace contact events should be delivered to each webhook destination.

An event subscription connects a webhook destination to one or more contact lifecycle events. Leadpush sends a delivery when a subscribed event happens and both the subscription and destination are enabled.

Before you start

  • Create at least one webhook destination.
  • Confirm the destination receiver can accept a test delivery.
  • Decide which contact events the receiver needs.
  • Make sure you are in the correct workspace.

Create an event subscription

Open Webhooks

Open Integrations, choose Webhooks, and go to Event Subscriptions.

Create a subscription

Click Create Subscription.

Choose a destination

Select the webhook destination that should receive the events.

Name the subscription

Use a recognizable name, such as CRM Contact Sync or Lifecycle Audit Feed.

Select events

Choose one or more contact lifecycle events.

Save the subscription

Save the subscription and leave it enabled when deliveries should start immediately.

Supported contact events

EventUse it when
contact.createdA downstream system needs every new contact.
contact.updatedA downstream system needs contact profile or attribute changes.
contact.deletedA downstream system should remove or mark deleted contacts.
contact.subscribedA downstream system tracks email subscription status.
contact.unsubscribedA downstream system tracks unsubscribe events.

Delivery behavior

Leadpush only sends a contact event delivery when:

  • the event subscription is enabled
  • the destination is enabled
  • the subscription includes the event type
  • the event belongs to the same workspace as the destination

If a destination is disabled, Leadpush does not create new contact event deliveries for that destination.

Subscription strategy

Use separate subscriptions when receivers have different responsibilities. For example:

  • send contact.created and contact.updated to a CRM
  • send contact.unsubscribed to a compliance system
  • send all lifecycle events to a data warehouse

Use one subscription with multiple events when the same receiver should handle the same payload family.

Edit or disable a subscription

Edit a subscription when you need to change the destination, name, enabled state, or selected events. Disable a subscription when you want to pause new deliveries but keep the configuration.

Deleting a subscription stops future deliveries for that subscription. Existing delivery history remains tied to the delivery records that were already created.

Troubleshooting

Create Webhook Destinations

Create, edit, enable, disable, test, and secure reusable webhook destinations in Leadpush.

Template Variables and Payloads

Understand Leadpush webhook template variables, default payloads, contact lifecycle event payloads, and test webhook payloads.