Create Webhook Endpoint

Developing

POST

/v1/libraries/{libraryId}/webhooks/endpoints

Register a new webhook endpoint to receive event notifications from this library.
Each endpoint can subscribe to one or more event types.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Entity

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-staging.tenbyte.io/v1/v1/libraries/314221a1-3cbf-4d3c-846e-f6c22bc43064/webhooks/endpoints' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "url": "https://example.com/webhook",
  "name": "Video processing events",
  "events": [
    "created",
    "queued"
  ],
  "secret": "auto-generate"
}'

Response Example

201 - Success

{
    "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
}

Modified at 2025-11-10 13:12:05

List Chapter

List Webhook Endpoints