Skip to content

Subscribe webhooks with the API

REST hooks for Zapier-style tools: subscribe a URL to a form's responses, list them and unsubscribe.

Written by
Updated

FormsAI Pro

POST /forms/:id/webhooks with { "url": "https://…" } subscribes a URL to response.completed. The URL must use https.

JSON
{
  "webhook": {
    "id": "w_…",
    "url": "https://example.com/hooks/forms",
    "secret": "whsec_…",
    "enabled": true,
    "event": "response.completed",
    "created_at": "2026-10-26T10:00:00.000Z"
  }
}
  • Keep the secret to verify signatures.
  • GET /forms/:id/webhooks lists them; DELETE /forms/:id/webhooks/:wid unsubscribes.
  • A form can have up to 10 webhooks, whether added here or in the app.
  • Deliveries, retries and the delivery log work exactly like webhooks added in Results → Connect.