Skip to main content
POST
Subscribe to an event

Authorizations

Authorization
string
header
required

A Formitto API key created in the dashboard (Settings → API keys). Pass it as Authorization: Bearer fmt_live_....

Body

application/json
event
enum<string>
required

The account event to subscribe to. The key must hold the matching read scope.

Available options:
form.submitted,
booking.created,
booking.rescheduled,
order.paid
target_url
string<uri>
required

The HTTPS destination Formitto POSTs each matching event to.

Response

The created subscription, including the one-time secret.

A newly created subscription. secret is shown ONCE here and never again — store it to verify delivery signatures.

id
string
required
event
enum<string>
required
Available options:
form.submitted,
booking.created,
booking.rescheduled,
order.paid
target_url
string<uri>
required
secret
string
required

The one-time plaintext signing secret. Not retrievable later.

created_at
string<date-time>
required