Subscribe to an event
webhooks
Subscribe to an event
Subscribe this API key to an account event. The key must hold the read scope matching the event (form.submitted → read:submissions; booking.created / booking.rescheduled → read:bookings; order.paid → read:orders). The response includes a secret shown ONLY here — store it; deliveries are signed and only the secret’s hash is retained.
POST
Subscribe to an event
Authorizations
A Formitto API key created in the dashboard (Settings → API keys). Pass it as Authorization: Bearer fmt_live_....
Body
application/json
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.