Skip to main content
Webhooks are automatic notifications that fire the moment something changes in your Lusha account. Instead of manually checking for updates, your external tools receive a notification as soon as an event occurs - keeping everything in sync without any manual work. You can now create and manage webhook subscriptions directly from the API Hub in Lusha. No API configuration required.

​
What you’ll need

  • Admin access to your Lusha account
  • An API key (Grab your key from the API Hub → Manage API Keys)
  • A target URL - the endpoint where Lusha will send webhook payloads

​
Available event types

Right now, one event type is available:
  • Opt Out - fires when a contact you’ve previously revealed opts out of Lusha’s database. Use this to automatically update your CRM or suppression tables and stay compliant with consent requirements.
Coming soon: Signals webhooks are on the way. You’ll be able to subscribe to buying signal events and act the moment they fire - no manual checking needed.

​
How to create a webhook

1

Open the Webhooks page

Go to API Hub → Webhooks.
2

Create a webhook

Click + Create Webhook.
3

Select an event type

Select an event type. Currently available: Opt Out - fires when a revealed contact opts out.
Selecting an event type when creating a webhook
4

Name the webhook

Enter a Webhook name.
5

Select an API key

Select your API key from the dropdown.
6

Enter the target URL

Enter your Target URL - the endpoint that will receive the event payload.
7

Save the webhook

Click Save Webhook.Your new webhook will appear in the Webhook Subscriptions table with a status toggle. It’s active as soon as it’s saved.
New webhook listed in the Webhook Subscriptions table
You can enable or disable any webhook at any time using the status toggle in the subscriptions table. Disabled webhooks will not send notifications.

​
Managing your webhooks

From API Hub → Webhooks, you can:
  • Toggle a webhook on or off using the status switch
  • Use the ⋮ menu to edit or delete a subscription
  • Click Regenerate secret to rotate your webhook signing secret
Regenerating your webhook secret will invalidate your current secret immediately. Any systems using the old secret to verify webhook payloads will need to be updated.
You’re all set! Your webhook will now notify your systems automatically whenever the subscribed event occurs.