Skip to content
Dashboard
Theme
Theme

Send a sample event to the relay (sandbox only)

POST /v1/dev/trigger: Send a sample event to the relay (sandbox only).

View Markdown

POST /v1/dev/trigger

A sample event of type (see the webhook event catalogue) for ohauthcat trigger, streamed to the environment’s open relays only. It is never stored as an event, sent to webhook endpoints or retried. Sandbox environments only; at most 20 per minute per environment (rate_limited with Retry-After).

Scope
webhooks:write
Auth
Secret key (sk_…)
Since
1.0
  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

  • Idempotency-Key string

    Honoured for 24 h; a replay returns the original response.

    min length 1 · max length 255

  • type string Required

    min length 1

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://api.ohauthcat.com/v1/dev/trigger" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "default"
}'
Response 202
{
"object": "dev_event",
"id": "evt_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"type": "default",
"created_at": "2026-01-15T09:30:00Z"
}