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

# Webhooks

> Send data to external services using custom HTTP requests from Moments.

## What it does

Webhooks let you send data from Bigdelta to any external service by making HTTP requests. They are available as an action type within moments — there is no separate integration to connect.

Use webhooks to push data to tools like Zapier, n8n, Make, or your own custom APIs.

***

## How to use webhooks

Webhooks are configured as action steps inside moments. No separate setup is required.

<Steps>
  <Step title="Open a moment">
    Navigate to the moment where you want to add a webhook.
  </Step>

  <Step title="Add a step">
    Click **Add Step** and select **Send Webhook**.
  </Step>

  <Step title="Configure the request">
    Set the HTTP method, URL, headers, and body for the webhook.
  </Step>
</Steps>

***

## Configuration options

| Setting     | Description                                                                      |
| ----------- | -------------------------------------------------------------------------------- |
| **Method**  | The HTTP method: GET, POST, PUT, DELETE, or PATCH                                |
| **URL**     | The endpoint to send the request to. Supports personalization variables          |
| **Headers** | Key-value pairs sent with the request (e.g., authorization tokens, content type) |
| **Body**    | The request payload in JSON format. Supports personalization variables           |

### Personalization variables

Both the URL and body fields support personalization variables. These let you include dynamic account data in your webhook requests — such as account name, MRR, plan, or any custom property.

***

## Example configuration

Here is an example webhook that sends account data to an external API when a customer churns:

| Setting     | Value                                                                                |
| ----------- | ------------------------------------------------------------------------------------ |
| **Method**  | POST                                                                                 |
| **URL**     | `https://api.example.com/webhooks/churn`                                             |
| **Headers** | `Content-Type: application/json`, `Authorization: Bearer your-api-key`               |
| **Body**    | `{"account_name": "{{account.name}}", "mrr": "{{account.mrr}}", "event": "churned"}` |

***

## Use cases

* Send churn alerts to a custom dashboard or analytics tool
* Trigger workflows in Zapier, n8n, or Make
* Push account data to an internal CRM or data warehouse
* Notify external systems when subscription changes occur

<Tip>
  If the external service requires authentication, add an `Authorization` header with the appropriate token or API key.
</Tip>

<Note>
  Webhooks are fire-and-forget. Bigdelta sends the request but does not retry on failure. Make sure your receiving endpoint is reliable and returns a response quickly.
</Note>