Alerts

Create alert

Create a new alert for the project.

post/v0/alerts

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/alerts
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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.

Request body

namestring required
trigger_type'event' | 'user' required
secretstring

Webhook signing secret

Response

Alert created

idstring required
namestring required
created_atstring date-time
updated_atstring date-time nullable
trigger_type'event' | 'user' required
status'active' | 'inactive' required
project_idstring required
has_secretboolean

Changes

No recorded changes to this operation across all 1 revision of this API.