DocsAPI referenceWebhooks

Get the signing secret

The account's webhook signing secret, created on the first read. Every delivery, to the default endpoint and to a job's webhook_url, is signed with it.

GET /v1/webhook-secret

Needs an API key: Authorization: Bearer $VIDEXO_API_KEY.

Request

bash

curl "$VIDEXO_API_URL/v1/webhook-secret" \
  -H "Authorization: Bearer $VIDEXO_API_KEY"

JavaScript

const response = await fetch(`${process.env.VIDEXO_API_URL}/v1/webhook-secret`, {
  headers: { Authorization: `Bearer ${process.env.VIDEXO_API_KEY}` },
});
const secret = await response.json();

Response

200 JSON

{
  "secret": "whsec_MfKQ9r8GKYqrTwjU...",
  "created_at": "2026-11-04T09:00:00.000Z",
  "rotated_at": null,
  "previous_secret_expires_at": null
}

Responses

Responses
Status	Body	When
200	WebhookSecret	The signing secret.
401	Problem	authentication_failed (missing_api_key, invalid_api_key, api_key_revoked, api_key_expired)
403	Problem	permission_denied (token_scope): a client token cannot call this route
429	Problem	rate_limited, with Retry-After in seconds