VoiceLayerDocs
Dashboard

List webhook subscriptions

GET
/v1/webhooks/subscriptions

Returns every webhook subscription in your workspace. Signing secrets are never returned after creation; if you lose one, create a new subscription.

Requires an API key with the webhooks:manage scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Response Body

Subscriptions this caller can see

application/json
  1. response
subscriptions*array<>
Example Request
curl https://api.vlayers.ai/v1/webhooks/subscriptions \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "subscriptions": [    {      "id": "0192f5a7-3c4d-7e5f-8a6b-7c8d9e0f1a23",      "projectId": "0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45",      "url": "https://example.com/voicelayer/webhooks",      "eventTypes": [        "message.*",        "conversation.*"      ],      "description": "Production receiver",      "enabled": true,      "createdByKeyId": "key_7f2a91",      "restrictTags": [],      "createdAt": "2026-10-20T15:04:05.000Z",      "updatedAt": "2026-10-20T15:04:05.000Z"    }  ]}