Skip to main content
POST
Create a webhook endpoint
Requires workspace access to async APIs. Signing secrets are returned only on creation or rotation.

Authorizations

Authorization
string
header
required

Bearer token authentication

Body

application/json
url
string<uri>
required
name
string
Required string length: 1 - 120
events
enum<string>[]
Minimum array length: 1
Available options:
job.created,
job.status_changed,
job.progress,
job.completed,
job.failed,
job.cancelled,
job.expired,
video.created,
video.status_changed,
video.progress,
video.completed,
video.failed,
video.cancelled,
video.expired,
batch.created,
batch.status_changed,
batch.progress,
batch.completed,
batch.failed,
batch.cancelled,
batch.expired

Response

Webhook endpoint created

id
string
required
workspaceId
string
required
name
string
required
url
string
required
status
enum<string>
required
Available options:
active,
disabled,
deleted
events
string[]
required
hasSecret
boolean
required
signing_secret
string
required

Returned only on creation or rotation.

createdBy
string | null
createdAt
string<date-time> | null
updatedAt
string<date-time> | null
deletedAt
string<date-time> | null
Last modified on October 18, 2026