Create a webhook subscription

POST/v1/webhooks

Needs a bearer access token with the webhooks.write scope. How authentication works

Subscribes target_url (must be https://) to one or more of the events listed in the Webhooks guide. The response includes a signing secret exactly once — store it immediately, since Florisage never shows it again and uses it to sign every delivery (see the Webhooks guide for how to verify a delivery).

curl -X POST "https://florisage.com/api/v1/webhooks" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "target_url": "https://example.com/webhooks/florisage",
  "events": [
    "enrolment.created",
    "enrolment.completed"
  ]
}'

201Webhook created — response includes `secret` once, never shown again

Request bodyapplication/jsonrequired

target_urlstringrequired
Must be https://
eventsarray of stringrequired
Allowed values:enrolment.createdenrolment.completedcertificate.issueduser.createdcourse.published

Responses

201Webhook created — response includes secret once, never shown again