Skip to main content
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

​
data
array
Array of registered webhook endpoint objects.

​
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

​
url
string
required
The HTTPS destination URL where Revont should send event payloads. Must be a valid https:// URL — plain HTTP is not accepted.
​
events
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.
​
description
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

​
id
string
Unique identifier for the newly created webhook endpoint.
​
url
string
The destination URL you registered.
​
events
array
The event types this endpoint is subscribed to.
​
description
string
The label you provided, if any.
​
created_at
string
ISO 8601 timestamp indicating when the webhook was registered.
​
status
string
Always active for a newly created webhook.
​
secret
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

​
id
string
required
The unique ID of the webhook endpoint to delete.

​
Response

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