API referenceWebhook endpoints
Create a webhook endpoint
POST
Events are signed per the Standard Webhooks spec with the returned secret. Failed
deliveries are retried 7 times over about 22 hours; an endpoint is disabled after 3 days
of continuous failure or a 410 Gone. Output URLs inside events expire after an hour;
fetch the generation for fresh ones. Requires the webhooks:write scope.
bearerAuthheader
AuthorizationBearer <token>API key, e.g. rf_live_3f9k2q_….
application/json- body
url*stringMatch
^https://Format
uriLength
length <= 2048description?stringLength
length <= 200event_types?array<>Defaults to all event types.
Endpoint created. secret is returned only in this response.
application/json- response
object*unknownid*stringMatch
^whe_url*stringFormat
uridescription?stringevent_types*array<>status*stringValue in
"enabled""disabled""auto_disabled"created_at*stringFormat
date-timesecret*stringSigning secret, whsec_….
curl -X POST 'https://api.rawframe.dev/v1/webhook_endpoints' \ -H 'Content-Type: application/json' \ -d '{ "url": "http://example.com"}'Example Response
{ "object": "webhook_endpoint", "id": "string", "url": "http://example.com", "description": "string", "event_types": [ "generation.succeeded" ], "status": "enabled", "created_at": "2019-08-24T14:15:22Z", "secret": "string"}