Send a sample event to the relay (sandbox only)
POST /v1/dev/trigger: Send a sample event to the relay (sandbox only).
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
Headers
Section titled “Headers”
Minor version; defaults to the environment’s pin.OhAuthCat-Versionstring
Honoured for 24 h; a replay returns the original response.Idempotency-Keystringmin length 1 · max length 255
Request body
Section titled “Request body”typestring Requiredmin length 1
Responses
Section titled “Responses”- 202 Accepted DevEvent
- 400 Invalid request. Codes: parameter_invalid, parameter_missing, version_unsupported and resource-specific codes from the catalogue. Error
- 401 Codes: authentication_required, api_key_invalid. Error
- 403 Codes: api_key_scope_missing, ip_not_allowed, plan_limit_reached. Error
- 409 Codes: idempotency_key_reused and resource-specific conflicts. Error
- 429 Code: rate_limited. Retry-After is set. Error
- 503 Code: service_unavailable. Retry-After is set; writes are paused. Error
- default Any other error, including internal_error. Every code is in the error catalogue. Error
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"}'const response = await fetch("https://api.ohauthcat.com/v1/dev/trigger", { method: "POST", headers: { Authorization: `Bearer ${process.env.OHAUTHCAT_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "type": "default" }),});const data = await response.json();import osimport requests
response = requests.post( "https://api.ohauthcat.com/v1/dev/trigger", headers={"Authorization": f"Bearer {os.environ['OHAUTHCAT_API_KEY']}"}, json={ "type": "default", },)data = response.json(){ "object": "dev_event", "id": "evt_01J9Z3K5V7W8X9Y0Z1A2B3C4D5", "type": "default", "created_at": "2026-01-15T09:30:00Z"}