Lusha

Lusha Webhooks API

Subscription management for real-time signal callbacks — bulk create and delete up to 25 items per request, account-level HMAC-SHA256 secret with rotation, delivery test, contact opt-out notifications, and a delivery audit log with statistics.

GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/subscriptions Subscribe a webhook to signal events · Create Subscription #
Ask an LLM
“How do I get real-time signal notifications sent to my server?”
“How many webhook subscriptions can I create in one request?”
Tell an agent
Create webhook subscriptions {subscriptions} with defaults {defaults}.
Set up signal webhooks named {name}: {subscriptions}, using defaults {defaults}.
GET /api/subscriptions List webhook subscriptions · List Subscriptions #
Ask an LLM
“Which webhook subscriptions do I have set up?”
“How do I page through more than ten webhook subscriptions?”
Tell an agent
List my webhook subscriptions.
Show {limit} webhook subscriptions starting at offset {offset}.
GET /api/subscriptions/{id} Get one webhook subscription · Get Subscription by ID #
Ask an LLM
“How do I see the settings of one webhook subscription?”
“Is a particular webhook subscription still active?”
Tell an agent
Show webhook subscription {id}.
Check whether webhook subscription {id} is active.
PATCH /api/subscriptions/{id} Change or reactivate a webhook subscription · Update Subscription #
Ask an LLM
“How do I change the URL a webhook subscription posts to?”
“Can I re-enable a webhook subscription that was auto-disabled?”
Tell an agent
Point webhook subscription {id} at {url}.
Reactivate webhook subscription {id}.
POST /api/subscriptions/{id}/test Send a test event to a webhook · Test Subscription #
Ask an LLM
“How do I check my webhook endpoint works before going live?”
“Do test webhook deliveries use up credits?”
Tell an agent
Send a test signal to webhook subscription {id}.
Test subscription {id} in {mode} mode.
POST /api/subscriptions/delete Delete webhook subscriptions · Delete Subscriptions #
Ask an LLM
“How do I delete several webhook subscriptions at once?”
“What happens if only some webhook deletions succeed?”
Tell an agent destructive · confirm first
Delete webhook subscriptions {ids}.
Remove the subscriptions {ids} and report which ones failed.
GET /api/audit-logs View webhook delivery logs · Get Audit Logs #
Ask an LLM
“Why did my webhook deliveries fail?”
“Can I see only failed deliveries for one subscription?”
Tell an agent
Show webhook delivery logs for subscription {subscriptionId}.
List webhook deliveries with status {status}.
GET /api/audit-logs/stats Get webhook delivery statistics · Get Audit Log Statistics #
Ask an LLM
“What's my webhook delivery success rate?”
“How many deliveries failed for a given subscription overall?”
Tell an agent
Show delivery statistics for my webhooks.
Summarize delivery stats for subscription {subscriptionId}.
GET /api/account/secret Get the account webhook secret · Get Account Secret #
Ask an LLM
“Where do I find the secret to verify webhook signatures?”
“What is my current account-wide webhook secret?”
Tell an agent
Show my account webhook secret.
Get the secret I use to verify incoming webhooks.
POST /api/account/secret/regenerate Rotate the account webhook secret · Regenerate Account Secret #
Ask an LLM
“How do I rotate my webhook signing secret?”
“Does regenerating the account secret affect all my subscriptions?”
Tell an agent destructive · confirm first
Regenerate my account webhook secret.
Rotate the webhook secret for every subscription on my account.
POST /api/subscriptions/opt-out Get notified when contacts opt out · Create Opt-Out Subscription #
Ask an LLM
“How do I learn when a contact asks to be removed so I can update my CRM?”
“Can I receive a webhook for data processing opt-outs?”
Tell an agent
Send opt-out notifications for {entityType} to {url}.
Create an opt-out webhook named {name} posting {entityType} removals to {url}.

Documentation

📖
Documentation
https://docs.lusha.com/apis/openapi/webhooks

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/openapi/lusha-webhooks-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/overlays/lusha-webhooks-overlay.yaml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/asyncapi/lusha-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lusha:lusha-webhooks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lusha-webhooks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lusha Webhooks API
  version: ''
  contact:
    name: Lusha Support
    url: https://api.lusha.com
    email: support@lusha.com
  license:
    name: Proprietary
    url: https://lusha.com/legal/terms
  termsOfService: https://lusha.com/legal/terms
  x-logo:
    url: https://www.lusha.com/logo.png
  x-privacy-policy:
    name: Privacy Policy
    url: https://lusha.com/legal/privacy-notice/
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: lusha-openapi.yml, lusha-v2-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.lusha.com
  description: Production server
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lusha/refs/heads/main/openapi/lusha-webhooks-api-openapi.yml