POST /v1/webhooks
Tags: webhooks
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Idempotency-Key | header | string,null | Optional idempotency token; replays return cached response. |
Request body
Required.
JSON
{
"$ref": "#/components/schemas/CreateWebhookRequest"
}Responses
201 — secret returned in body — shown ONCE
JSON
{
"$ref": "#/components/schemas/CreateWebhookResponse"
}400 — INVALID_REQUEST — bad URL / events / name
401 — Unauthenticated
403 — FORBIDDEN — admin role required in org
Code samples
TypeScript
TypeScript
import { firecase } from "@firecase/sdk";
const result = await firecase.post("/webhooks", { /* body */ });
console.log(result);Python
Python
import firecase
result = firecase.post("/webhooks", json={})
print(result)curl
Bash
curl -X POST https://api.firecase.ai/v1/webhooks \
-H "Authorization: Bearer $FIRECASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'