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

# Set up webhooks

> Add an Atlas Connect webhook endpoint.

Atlas sends selected events to an HTTPS endpoint that you control.

## Add a webhook

Admins can manage webhook endpoints in the [Atlas Merchant Portal](https://portal.atlas.kitchen/atlas-connect/webhooks).

1. Go to **Atlas Connect > Webhooks**.
2. Click **Add webhook**.
3. Enter a **Name**.
4. Enter an **Endpoint URL**. The URL must start with `https://`.
5. Choose whether the webhook is **Enabled**.
6. Select the **Events** this endpoint should receive.
7. Choose **Authentication**:
   * **Bearer token** — Atlas sends `Authorization: Bearer <token>`.
   * **Custom header** — Atlas sends the header name and value you provide.
8. Save the webhook.

Disabled webhooks stay saved but do not receive events until re-enabled.

Secrets are stored for delivery and are not shown again after saving.

## Delivery

Atlas sends a `POST` request with a JSON event payload.

Return any `2xx` response to acknowledge receipt.

<Info>
  Process events idempotently. Atlas queues webhook delivery asynchronously, and your endpoint may receive the same event more than once.
</Info>