v1

latestOpenAPI 3.0.12026-07-2210997354.2 KB

Webhooks

Create webhook

Creates a webhook for a project to receive HTTP notifications when content changes.

Deliveries use the audio.updated action type. See #/components/examples/audioUpdatedWebhookDeliveryExample for a representative payload (media IDs are integers, content_type values are mp3/m3u8/mp4, and duration is in seconds).

post/projects/{project_id}/webhooks

Request body

urlstring required

The URL that BeyondWords will send webhook notifications to. This URL must be served over HTTPS

headersobject

use_static_ipboolean

Whether requests to URL should originate from a static IP address.

enabledboolean

Whether or not the webhook is enabled or disabled Has the value true if enabled. The default is true.

Response

successful

idinteger

Unique identifier for the object

urlstring

The URL that BeyondWords will send webhook notifications to. This URL must be served over HTTPS

headersobject

enabledboolean

Whether or not the webhook is enabled or disabled Has the value true if enabled. The default is true.

use_static_ipboolean

Whether requests to URL should originate from a static IP address.

createdstring date-time

Time at which the object was created (ISO 8601)

updatedstring date-time

Time at which the object was updated (ISO 8601)