latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

webhook

Get a webhook

Retrieves a single webhook subscription: its target URL and the events currently delivered to it. Use GET /webhooks to discover the identifiers of your webhooks.

Permission: No specific permission required. A valid API key is sufficient.

Monitoring: Not needed.

get/webhooks/{webhookId}

Path parameters

webhookIdstring uuid required

Example:bc5c5a41-44c5-5b7c-a521-45bf56d82cbe

The identifier of the webhook, as returned in the uuid field.

Response

Successful operation — returns the webhook details.

uuidstring uuid required

The identifier of the webhook: an RFC 4122 v5 UUID derived from target_url in the URL namespace. The same target URL always yields the same identifier, and it is stable for the lifetime of the subscription.

target_urlstring uri required

The URL Ringover POSTs the subscribed events to. Immutable.

eventsWebhookEvent[] required

The events delivered to target_url, in catalog order.

signing_keystring

The key used to sign the deliveries sent to your endpoints (see Securing your webhooks in the webhook tag description). Read-only and shared by every subscription of your configuration. Absent while no key has been generated yet.

Example response

{
  "uuid": "bc5c5a41-44c5-5b7c-a521-45bf56d82cbe",
  "target_url": "https://api.example.com/webhooks/ringover",
  "events": [
    "call.started",
    "call.answered",
    "call.ended"
  ],
  "signing_key": "b7c1f2e4a9d84c3f8e5b6a7d9c0e1f23"
}