Skip to main content
Webhooks send deployment and task events to your service. Create one in Settings → Webhooks, through MCP’s create_webhook, or with the API below. For task results, use callbacks.

Subscribe

With BEAM_TOKEN and WORKSPACE_ID set in your environment:
Save the signing secret from the response. It is only shown once. Filter by event name, such as stub.deploy, or prefix, such as task.*. Use * or an empty list for all eligible events. Logs, container metrics, and internal platform events are excluded. Use logs and metrics for those.

Verify Signatures

Requests use CloudEvents JSON with Content-Type: application/cloudevents+json. Headers include: Verify the raw body using the full signing secret, including whsec_:
Delivery times out after 10 seconds and is not retried. Handle duplicate event IDs and use the workspace API to recover missed updates.

Manage Subscriptions

Changes can take about 15 seconds to apply.