Webhooks
Test Subscription
Test a webhook subscription by sending a test signal. Supports three test modes.
Endpoint: (POST) https://api.lusha.com/api/subscriptions/{id}/test
Test Modes:
direct- Quick HTTP check only (validates URL responds correctly)kafka- Fanout handler only (tests Kafka message processing)full- Complete Kafka flow (default - end-to-end test)
What Gets Tested:
- URL accessibility and response time
- Complete delivery pipeline (for full mode)
- Signature generation and headers
Important Notes:
- Test deliveries do NOT consume credits
- Test payloads use mock data
- Useful for verifying webhook configuration before going live
POST
Test Subscription
Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Path Parameters
Subscription ID
Query Parameters
Test mode
Available options:
direct, kafka, full Response
Test executed successfully
Subscription ID that was tested
Example:
"507f1f77bcf86cd799439011"
Webhook URL that was tested
Example:
"https://example.com/webhook"
Test mode used
Available options:
direct, kafka, full Example:
"full"
Overall test success
Example:
true
When the test was executed
Example:
"2024-01-01T00:00:00.000Z"
Name of the subscription
Example:
"My Test Webhook"
Results of the test
Test payload that was sent