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

# Webhook

Receive real-time form submission data as JSON payloads delivered directly to your server endpoint. Webhooks allow you to automate workflows, trigger downstream actions, and integrate Simplicity AI with your own systems — without polling the API.

<Steps>
  <Step title="Add a New Webhook">
    Navigate to the **Integrations** section in your dashboard and click **Add New Webhook** to register a new endpoint.

    <img src="https://mintcdn.com/protonlabstechnologyincltd/LQ_ToWYZu7Y2osB2/images/create-webhook.png?fit=max&auto=format&n=LQ_ToWYZu7Y2osB2&q=85&s=310ed3490ef370efa896c74ba195a439" alt="Add a new webhook" width="1364" height="588" data-path="images/create-webhook.png" />

    Each webhook you register will listen for form submission events and forward the data to the URL you specify. You can register multiple webhooks — for example, to route events to different services such as a CRM, a database, or a notification system.
  </Step>

  <Step title="Configure Your Endpoint">
    Enter your publicly accessible endpoint URL and set an **Authorization header value**.

    <img src="https://mintcdn.com/protonlabstechnologyincltd/LQ_ToWYZu7Y2osB2/images/create-webhook2.png?fit=max&auto=format&n=LQ_ToWYZu7Y2osB2&q=85&s=0de0506b7791dd949cee78a0b9f3b076" alt="Configure endpoint and authorization header" width="1090" height="654" data-path="images/create-webhook2.png" />

    The authorization header is sent with every request so your server can verify that incoming payloads are genuinely from Simplicity AI and not from an unknown or malicious source. On your server, validate this header before processing any payload.

    Your endpoint should respond with a `200 OK` status code to acknowledge receipt. Any other response code will be treated as a failed delivery and may trigger a retry.
  </Step>

  <Step title="Manage & Monitor">
    From the **Webhook Dashboard**, you have full visibility and control over all your registered webhooks.

    <img src="https://mintcdn.com/protonlabstechnologyincltd/LQ_ToWYZu7Y2osB2/images/create-webhook4.png?fit=max&auto=format&n=LQ_ToWYZu7Y2osB2&q=85&s=ebb14eaa3c3d85e6760d437363bcd0be" alt="Webhook dashboard" width="1095" height="655" data-path="images/create-webhook4.png" />

    * You can also see all your successful and failed webhook events from your webhook dashboard

    <img src="https://mintcdn.com/protonlabstechnologyincltd/LQ_ToWYZu7Y2osB2/images/webhook-events.png?fit=max&auto=format&n=LQ_ToWYZu7Y2osB2&q=85&s=50a9b0233012bde576c9d95a63480d9d" alt="Webhook event logs" width="920" height="637" data-path="images/webhook-events.png" />

    For each webhook, you can:

    * **View delivery history** — inspect every event that was sent, including the full request payload and server response.
    * **Debug failures** — identify failed deliveries, see the error response returned by your server.
    * **Monitor status** — quickly see which webhooks are active, paused, or experiencing repeated failures.
    * **Edit or delete** — update your endpoint URL or authorization header at any time, or remove a webhook entirely.

    <Note>
      If your endpoint is temporarily unavailable, Simplicity AI will automatically retry failed deliveries with exponential backoff to avoid data loss.
    </Note>
  </Step>
</Steps>