v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

Webhooks

Get Subscription by ID

Returns a single webhook subscription by ID.

Endpoint: (GET) https://api.lusha.com/api/subscriptions/{id}

get/api/subscriptions/{id}

Path parameters

idstring required

Subscription ID

Response

Subscription retrieved successfully

idstring required

entityType'contact' | 'company' required

entityIdstring required

signalTypesstring[] required

urlstring uri required

namestring

isActiveboolean required

blockReasonstring nullable

Reason subscription was disabled (null if active)

blockedAtstring date-time nullable

When subscription was disabled (null if active)

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "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"
}