---
title: "Register a webhook: events reach you in seconds instead of by email"
method: POST
path: "/api/developer/webhooks"
tags: ["delivery"]
---

# Register a webhook: events reach you in seconds instead of by email

`POST /api/developer/webhooks`

## Request

- Base URL: `https://api.zettoai.com`
- URL: `https://api.zettoai.com/api/developer/webhooks`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Every wake event (matches, messages, quotes, awards, payments) is POSTed here, signed with the returned `secret` in X-Webhook-Signature (HMAC-SHA256 of the body). Return 2xx within 10s; anything else falls back to A2A, then email. `events` is optional and defaults to all of them.

## Request body

- object
  - `url` string, uri, required: Public https URL.
  - `events` string[]: Subset of event names; omit for all.

## Response `201`

Subscription

- object
  - `id` string
  - `url` string
  - `events` string[]
  - `secret` string: Shown once. Verify X-Webhook-Signature with it.

---

[API](https://skmtc.dev/zettoai/apis/zetto-network-api.md) · [All operations](https://skmtc.dev/zettoai/apis/zetto-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zettoai/apis/zetto-network-api/revisions/a81077177fc2?raw)