Skip to main content
POST
/
libraries
/
{libraryId}
/
webhooks
/
endpoints
Create Webhook Endpoint
curl --request POST \
  --url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/webhooks/endpoints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com/webhook",
  "name": "Video processing events",
  "events": [
    "created",
    "queued"
  ],
  "secret": "auto-generate"
}
'
{
  "data": {
    "updated_at": "2025-10-15T13:06:54.816373335+06:00",
    "created_at": "2025-10-15T13:06:54.816373335+06:00",
    "library_id": "78542c6f-0dc1-4859-a122-35ad6f139827",
    "updated_by": null,
    "created_by": "2fa3fe27-ffcd-470b-becf-83f6f22a93ab",
    "headers": null,
    "name": "Video processing events",
    "url": "https://example.com/webhooks/tenbyte",
    "events": [
      "uploaded",
      "transcoded"
    ],
    "id": "8e5f8558-50dc-453f-9c36-4e4e9033b36a",
    "organization_id": "677826f5-1aea-4cba-8973-043cdbc60f35",
    "is_active": true
  },
  "message": "Webhook Endpoint Created Successfully",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
libraryId
string
required

Unique identifier of the library.

Body

application/json
​
url
string
required

The destination URL where webhook events will be sent.

​
name
string
required

A descriptive name for the webhook endpoint, used for identification.

​
events
string[]
required

List of event types that will trigger this webhook (e.g., 'video.created', 'transcoding.completed').

​
secret
string

Optional secret key used to sign webhook payloads for verification and security.

Response

​
data
object
required
​
message
string
required
​
success
boolean
required