> ## Documentation Index
> Fetch the complete documentation index at: https://help.weavely.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks API

> Instantly deliver new form submissions to your endpoint using Weavely’s Webhooks API. Create, manage, and receive real-time webhook events easily.

<span className="weavely-jsonld" hidden>
  {`{
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "WebPage",
        "@id": "https://help.weavely.ai/developers/webhooks",
        "url": "https://help.weavely.ai/developers/webhooks",
        "name": "Webhooks API",
        "description": "Our Webhooks API instantly delivers each new submission to your specified endpoint URL or any compatible web application.",
        "inLanguage": "en",
        "isPartOf": {
          "@type": "WebSite",
          "@id": "https://help.weavely.ai/#website",
          "name": "Weavely Help Center"
        },
        "breadcrumb": {
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Developers", "item": "https://help.weavely.ai/developers" },
            { "@type": "ListItem", "position": 2, "name": "Webhooks API", "item": "https://help.weavely.ai/developers/webhooks" }
          ]
        },
        "publisher": { "@id": "https://www.weavely.ai/#org" }
      },
      {
        "@type": "TechArticle",
        "headline": "Webhooks API",
        "description": "Learn how to create and delete webhooks and receive real-time form submission payloads at your endpoint using Weavely’s Webhooks API.",
        "inLanguage": "en",
        "mainEntityOfPage": { "@id": "https://help.weavely.ai/developers/webhooks" },
        "author": { "@id": "https://www.weavely.ai/#org" },
        "publisher": { "@id": "https://www.weavely.ai/#org" }
      },
      {
        "@type": "Organization",
        "@id": "https://www.weavely.ai/#org",
        "name": "WEAVE.LY BV",
        "url": "https://www.weavely.ai",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "Herbert Hooverlaan 141",
          "addressLocality": "Schaarbeek",
          "postalCode": "1030",
          "addressCountry": "BE"
        },
        "identifier": "BE0773.878.569",
        "sameAs": [
          "https://www.instagram.com/weavely.ai/",
          "https://www.linkedin.com/company/weave-ly/",
          "https://www.youtube.com/@weavely"
        ]
      }
    ]
    }`}
</span>

## Create webhook

> POST api.weavely.ai/v1/forms/\[formId]/webhooks

### Request

#### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <token>`\
  Your personal token.
</ParamField>

#### Parameters

<ParamField path="formId" type="string" required>
  The ID of the form to attach the webhook to.
</ParamField>

#### Body

<ParamField body="url" type="string" required>
  The destination URL that will receive POST payloads when a form is submitted.
</ParamField>

### Response

<ResponseField name="id" type="string">
  The ID for the newly created webhook.
</ResponseField>

<ResponseField name="url" type="string">
  The URL you provided for receiving webhook events.
</ResponseField>

<ResponseField name="formId" type="string">
  The form ID this webhook is associated with.
</ResponseField>

## Delete webhook

> DELETE api.weavely.ai/v1/\[formId]/webhooks/\[webhookId]

### Request

#### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <token>`\
  Your personal token.
</ParamField>

#### Parameters

<ParamField path="formId" type="string" required>
  The ID of the form where the webhook is registered.
</ParamField>

<ParamField path="webhookId" type="string" required>
  The ID of the webhook to delete.
</ParamField>

### Response

None

## Webhook payload

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

```json theme={null}
{
  "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"
    }
  ]
}
```