{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"How to Set Up Webhooks in Lusha","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"how-to-set-up-webhooks-in-lusha","__idx":0},"children":["How to Set Up Webhooks in Lusha"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now create and manage webhook subscriptions directly from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub"]}," in Lusha. No API configuration required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-youll-need","__idx":1},"children":["What you'll need"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Admin access to your Lusha account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An API key (Grab your key from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub → Manage API Keys"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A target URL — the endpoint where Lusha will send webhook payloads"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"available-event-types","__idx":2},"children":["Available event types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Right now, one event type is available:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-create-a-webhook","__idx":3},"children":["How to create a webhook"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub → Webhooks"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Create Webhook"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select an event type. Currently available: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Opt Out"]}," — fires when a revealed contact opts out."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/138206470/21904062f615798efb47b282f2a0/Screenshot%2B2026-05-03%2Bat%2B21_42_52.png?expires=1780056000&signature=13b79e9673e8ebd1b8fd08b156b706495a62650ae5379093d0e2e95f735aace1&req=0dZnx1j8qDAolxv2%2BtxgpkslY8x13p5iDn%2FWPRWyUcCK2IvtnGiJIzvP5QX1%0AdkV%2FgvP7XXnixOAUm7nc6RnkjQ%3D%3D%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook name"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API key"]}," from the dropdown."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Target URL"]}," — the endpoint that will receive the event payload."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save Webhook"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your new webhook will appear in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook Subscriptions"]}," table with a status toggle. It's active as soon as it's saved."]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/138206543/c1381e93caa9245cc29c25688006/Screenshot%2B2026-05-03%2Bat%2B21_42_43.png?expires=1780056000&signature=cefeb150260543b6979c28e9caa7fbf060f9d81179015894dec20ec6d385d6c3&req=0dZnx1j8qTMrlxv2%2BtxgppbWryf9Lu1Agja6ICyBdOHAAD%2FP3M8qAaXHJuXv%0AugNFfvA56%2Fo50Am%2F675naPEmAg%3D%3D%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," You can enable or disable any webhook at any time using the status toggle in the subscriptions table. Disabled webhooks will not send notifications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"managing-your-webhooks","__idx":4},"children":["Managing your webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["From ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Hub → Webhooks"]},", you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Toggle a webhook on or off using the status switch"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["⋮"]}," menu to edit or delete a subscription"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Regenerate secret"]}," to rotate your webhook signing secret"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," 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."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You're all set! Your webhook will now notify your systems automatically whenever the subscribed event occurs."]}]},"headings":[{"value":"How to Set Up Webhooks in Lusha","id":"how-to-set-up-webhooks-in-lusha","depth":1},{"value":"What you'll need","id":"what-youll-need","depth":2},{"value":"Available event types","id":"available-event-types","depth":2},{"value":"How to create a webhook","id":"how-to-create-a-webhook","depth":2},{"value":"Managing your webhooks","id":"managing-your-webhooks","depth":2}],"frontmatter":{"title":"How to Set Up Webhooks in Lusha","description":"Create and manage webhook subscriptions directly from the Lusha UI - no API configuration required.","seo":{"title":"How to Set Up Webhooks in Lusha"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/webhooks/how-to-set-up-webhooks-in-lusha","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}