Webhooks API — Register and Manage Event Endpoints

The Webhooks API lets you create and manage webhook endpoints programmatically — without using the Revont UI. Use it when you need to register endpoints dynamically, automate your infrastructure setup, or manage webhooks as part of a deployment pipeline. Each webhook you create points to an HTTPS URL that Revont will send event payloads to when subscribed events occur. You choose which events each endpoint listens to at registration time. For a full list of available events and details on payload structure and signature verification, see the Webhooks integration guide.

List all webhooks

GET /webhooks

Returns all webhook endpoints registered in your workspace.

cURL

curl "https://api.revont.ai/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "wh_01HX9ABCDE",
      "url": "https://hooks.yourapp.com/revont",
      "events": ["call.ended", "summary.ready"],
      "description": "Production event handler",
      "created_at": "2024-02-01T10:00:00Z",
      "status": "active"
    },
    {
      "id": "wh_01HX9ABCDF",
      "url": "https://staging.yourapp.com/revont",
      "events": ["call.ended"],
      "description": "Staging environment",
      "created_at": "2024-01-15T08:30:00Z",
      "status": "disabled"
    }
  ]
}

Response Fields

array

Array of registered webhook endpoint objects.

Show Webhook object fields

string

Unique identifier for the webhook endpoint.

string

The HTTPS destination URL that Revont sends event payloads to.

array

List of event types this endpoint is subscribed to (e.g., call.ended, summary.ready).

string

Human-readable label for this webhook endpoint, if one was provided at creation.

string

ISO 8601 timestamp indicating when this webhook was registered.

string

Current status of the endpoint. Either active or disabled.

Create a webhook

POST /webhooks

Registers a new webhook endpoint. Revont will immediately begin delivering matching events to the URL you provide.

cURL

curl -X POST "https://api.revont.ai/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.yourapp.com/revont",
    "events": ["call.ended", "summary.ready"],
    "description": "Production event handler"
  }'

Request Body

string

required

The HTTPS destination URL where Revont should send event payloads. Must be a valid https:// URL — plain HTTP is not accepted.

array of strings

required

One or more event types to subscribe to. For example: ["call.ended", "summary.ready"]. You must specify at least one event.

string

An optional human-readable label for this webhook, such as Production event handler or CRM sync. Useful for identifying endpoints in the list view.

Response

On success, the API returns 201 Created with the new webhook object. The response includes a secret field containing the signing secret for this endpoint.

The signing secret is returned only when the webhook is created. Revont does not store it in retrievable form after this point. Save it securely immediately — if you lose it, you must delete this webhook and create a new one to get a new secret.

{
  "id": "wh_01HX9ABCDE",
  "url": "https://hooks.yourapp.com/revont",
  "events": ["call.ended", "summary.ready"],
  "description": "Production event handler",
  "created_at": "2024-03-20T12:00:00Z",
  "status": "active",
  "secret": "whsec_4f8a2b1c9d3e7f6a0b5c8d2e1f4a7b3c"
}

Response Fields

string

Unique identifier for the newly created webhook endpoint.

string

The destination URL you registered.

array

The event types this endpoint is subscribed to.

string

The label you provided, if any.

string

ISO 8601 timestamp indicating when the webhook was registered.

string

Always active for a newly created webhook.

string

The signing secret for this endpoint. Use this to verify that incoming payloads originate from Revont. Shown only once — store it immediately.

Delete a webhook

DELETE /webhooks/{id}

Permanently deletes a webhook endpoint. Revont immediately stops delivering events to the associated URL. This action cannot be undone.

cURL

curl -X DELETE "https://api.revont.ai/v1/webhooks/wh_01HX9ABCDE" \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

string

required

The unique ID of the webhook endpoint to delete.

Response

On success, the API returns 204 No Content with no response body.

​List all webhooks

​Response

​Response Fields

​Create a webhook

​Request Body

​Response

​Response Fields

​Delete a webhook

​Path Parameters

​Response

List all webhooks

Response

Response Fields

Create a webhook

Request Body

Response

Response Fields

Delete a webhook

Path Parameters

Response