Create a webhook endpoint
Subscribe an endpoint to one or more events.
Subscribe an endpoint to one or more events. The response carries the signing secret, and this is the only time it is returned. Endpoints must be publicly reachable HTTPS URLs on port 443; private and internal addresses are refused with 422 webhook-url-not-allowed. Needs a plan that includes webhooks; otherwise 403 plan-limit.
deployTokenAuthorizationBearer <token>A project deploy token, minted in the console under Settings, Developer, API tokens. Send the whole value, including the numeric prefix before the |. A token carries a set of abilities (push, pull, manage, read, write) and each operation requires one of them. Tokens do not inherit from each other: a manage token cannot read the glossary unless it also has read.
application/json- body
url*stringurilength <= 2048events*array<>1 <= itemsThe endpoint, with its signing secret.
application/json- response
id?integerurl?stringurievents?array<>active?booleanWhether the endpoint receives deliveries. Paused endpoints miss events; nothing is sent later.
created_at?|date-timelast_delivered_at?|When a delivery to this endpoint last succeeded.
date-timesecret?stringThe signing secret (whsec_...). It is returned in this response only and can never be read again. Use it to verify X-Transglot-Signature.
curl -X POST 'https://api.transglot.ai/v1/webhooks' \ -H 'Content-Type: application/json' \ -d '{ "url": "https://ci.example.com/hooks/transglot", "events": [ "batch.completed", "batch.failed" ]}'{ "id": 8, "url": "https://ci.example.com/hooks/transglot", "events": [ "batch.completed", "batch.failed" ], "active": true, "created_at": "2026-10-12T10:02:19+00:00", "last_delivered_at": null, "secret": "whsec_Zq8mB3vN6xR1tY4uI7oP0aS2dF5gH8jK9lQ3wE6r"}