Webhooks
List Subscriptions
Returns all webhook subscriptions for your account with pagination support.
Endpoint: (GET) https://api.lusha.com/api/subscriptions
Pagination:
- Results are sorted by createdAt in descending order (newest first)
- Default limit: 10, max limit: 100
- Use offset for pagination through large result sets
Note: The webhook secret is never returned in list responses for security.
get/api/subscriptions
Query parameters
limitinteger
Maximum number of results (1-100)
offsetinteger
Number of results to skip
Response
List of subscriptions retrieved successfully
Example response
{
"data": [
{
"id": "507f1f77bcf86cd799439011",
"entityType": "contact",
"entityId": "123456",
"signalTypes": [
"promotion",
"companyChange"
],
"url": "https://example.com/webhooks/lusha",
"name": "Contact Promotion Tracker",
"isActive": true,
"blockReason": "Max retries exceeded",
"blockedAt": "2026-01-14T10:00:00.000Z",
"createdAt": "2026-01-14T10:00:00.000Z",
"updatedAt": "2026-01-14T10:00:00.000Z"
}
],
"pagination": {
"total": 100,
"limit": 50,
"hasMore": true
}
}