v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB

Webhooks

List webhook endpoints

List the webhook endpoints registered under the tenant. Signing secrets are masked in this response — the full secret is only returned when you create an endpoint or rotate its secret. The response is a bare JSON array ordered by most recent creation time.

get/v1/webhooks

Response

A bare JSON array of webhook endpoint objects.

idstring uuid

You receive the UUID for this webhook endpoint.

labelstring

You receive the endpoint label.

urlstring uri

You receive the destination URL that receives POST deliveries.

secretstring

You receive the masked signing secret (only the last 4 characters are shown).

subscribed_eventsstring[]

You receive the event types this endpoint is subscribed to. An empty array means all event types are delivered.

enabledboolean

You receive true when the endpoint is active and receiving deliveries.

created_atstring date-time

You receive the timestamp when the endpoint was created.

updated_atstring date-time

You receive the timestamp when the endpoint was last updated.

Example response

[
  {
    "id": "b8f0f4a2-2b1e-4b3a-9d0e-4a1c2d3e4f50",
    "label": "Production events",
    "url": "https://api.acme.example/webhooks/didit",
    "secret": "********s9Zx",
    "subscribed_events": [
      "credential.issued",
      "presentation.verified"
    ],
    "enabled": true,
    "created_at": "2026-07-02T23:51:58.746686+00:00",
    "updated_at": "2026-07-02T23:51:58.746686+00:00"
  }
]