post
https://api-v2.pandavideo.com/user/webhook/
Register a new webhook for the authenticated account. Panda Video will send POST requests to the provided URL when relevant events occur (such as video processing completion, live stream lifecycle events, and dubbing/AI job updates).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
POST /user/webhook
Register a new webhook for the authenticated account. Panda Video will send POST requests to the provided URL when relevant events occur (such as video processing completion, live stream lifecycle events, and dubbing/AI job updates).
AuthorizationRequires a valid Panda API key in the
Authorizationheader. The webhook is registered under the organization that owns the API key.
HTTP Method & Path
POST /user/webhook
Base URL: https://api-v2.pandavideo.com
Authentication Requirements
- Security Scheme:
PandaAuth(apiKey) - Header:
Authorization: <your_api_token>(no Bearer prefix)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Request Body
Content-Type: application/json
Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Public HTTPS URL that will receive webhook events. Must be reachable from the public internet and accept POST requests with a JSON body. |
Example Request Body
{
"url": "https://your-server.com/panda-webhook"
}Response
Success Response (200)
Returns the created webhook record:
{
"id": "2f4460cc-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"url": "https://your-server.com/panda-webhook",
"user_id": "89552df0-cae4-489a-bea1-7f4f604c2142",
"updated_at": "2026-05-26T16:06:48.917Z",
"created_at": "2026-05-26T16:06:48.917Z"
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Unique ID of the webhook |
url | string | The URL registered to receive events |
user_id | string (uuid) | ID of the user that owns the webhook |
created_at | string (ISO 8601) | Creation timestamp |
updated_at | string (ISO 8601) | Last update timestamp |
Error Responses
- 401 Unauthorized: API token inválido ou ausente
- 403 Forbidden: Token sem permissão para acessar este recurso
- 422 Unprocessable Entity: URL inválida ou campo
urlausente - 500 Internal Server Error: Erro no servidor
Example Usage
cURL
curl -X POST \
'https://api-v2.pandavideo.com/user/webhook' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://your-server.com/panda-webhook"
}'