​
Create webhook

POST https://api.weavely.ai/v1/forms/{{formId}}/webhooks

​
Request

​
Headers

​
Authorization
string
required

Bearer <token>
Your personal token.

​
Parameters

​
formId
string
required

The ID of the form to attach the webhook to.

​
Body

​
url
string
required

The destination URL that will receive POST payloads when a form is submitted.

​
Response

​
id
string

The ID for the newly created webhook.

​
url
string

The URL you provided for receiving webhook events.

​
formId
string

The form ID this webhook is associated with.

​
Delete webhook

DELETE https://api.weavely.ai/v1/{{formId}}/webhooks/{{webhookId}}

​
Request

​
Headers

​
Authorization
string
required

Bearer <token>
Your personal token.

​
Parameters

​
formId
string
required

The ID of the form where the webhook is registered.

​
webhookId
string
required

The ID of the webhook to delete.

​
Response

None

​
Webhook payload

Example of the JSON payload delivered to your webhook endpoint when a form is submitted:

{
  "formId": "01234567-89ab-cdef-0123-456789abcdef",
  "responseId": "fedcba98-7654-3210-fedc-ba9876543210",
  "dateCreated": "2025-05-23T14:28:00Z",
  "answers": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "value": "Sample text answer"
    },
    {
      "id": "0f1e2d3c-4b5a-6978-01fe-dcba98765432",
      "value": "Option A, Option C"
    }
  ]
}