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

​
Add a webhook

Admins can manage webhook endpoints in the Atlas Merchant Portal.
  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.
Process events idempotently. Atlas queues webhook delivery asynchronously, and your endpoint may receive the same event more than once.