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 page 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 → Manage API Keys)
  • A target URL - the endpoint where Lusha will send webhook payloads

​
Available event types

You can subscribe to these event types:
  • 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.
  • Signals - fires when a buying signal is detected for a contact or company. All signal types are supported, including Intent. Use this to act the moment a signal fires - no manual checking needed.

​
How to create a webhook

1

Open the Webhooks page

Go to API → Webhooks.
2

Create a webhook

Click + Create Webhook.
3

Select an event type

Select an event type: Opt Out or one of the Signals events.
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 → 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.