Skip to help content
API, MCP and webhooks

Configure a webhook

Receive signed lifecycle events with retries and idempotent processing.

Create an endpoint

  1. Open Dashboard developer tools.
  2. Enter an HTTPS endpoint you control.
  3. Choose only the lifecycle events the integration needs.
  4. Copy the signing secret once and store it securely.

Respond quickly

Verify and enqueue the event, then return a successful response. Do expensive work asynchronously so timeouts do not create avoidable retries.

Retries

Astral uses a durable outbox, leases, and backoff. Your receiver must deduplicate by the event ID because delivery is at least once, not exactly once.

Related guides