Skip to main content
POST
/
webhooks
Subscribe to an event
curl --request POST \
  --url https://formitto.com/v1/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_url": "<string>"
}
'
{
  "id": "<string>",
  "target_url": "<string>",
  "secret": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.formitto.com/llms.txt

Use this file to discover all available pages before exploring further.

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