Skip to main content
POST

Authorizations

Authorization
string
header
required

Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API.

Headers

Idempotency-Key
string

Optional unique value (e.g. a UUID v4) that lets you safely retry POST/PUT/PATCH/DELETE requests. The first request runs normally; subsequent requests with the same key replay the stored response (status + body) for 24 hours, so retries can never double-create or double-charge. Two concurrent requests with the same key return 409 IDEMPOTENCY_IN_PROGRESS. Generate a fresh key per logical operation.

Maximum string length: 255

Body

application/json
name
string
required
Minimum string length: 1
trigger_type
enum<string>
required
Available options:
event,
user
trigger_filters
object[]
required
recipient
object[]
secret
string

Webhook signing secret

Response

Alert created

id
string
required
name
string
required
trigger_type
enum<string>
required
Available options:
event,
user
status
enum<string>
required
Available options:
active,
inactive
project_id
string
required
created_at
string<date-time>
updated_at
string<date-time> | null
trigger_filters
object[]
recipient
object[]
has_secret
boolean