---
title: "Subscribe to job/watch events"
method: POST
path: "/api/webhooks/subscribe"
---

# Subscribe to job/watch events

`POST /api/webhooks/subscribe`

## Request

- Base URL: `https://oxaide.com`
- URL: `https://oxaide.com/api/webhooks/subscribe`
- Auth: none declared

Events: brief.failed, brief.resent, audit.failed, watch.alert, watch.digest. Deliveries are HMAC-SHA256 signed (X-Oxaide-Signature). Owner-scoped: a subscription only receives its own email’s events. Stays pending until the emailed confirm link is clicked; secret is shown once, at activation.

## Request body

- object
  - `email` string, email, required
  - `url` string, required: Public https endpoint
  - `events` string: CSV subset (default: all five)

## Response `200`

Pending subscription id (secret shows at activation)

## Other responses

- `422`: Validation error

---

[API](https://skmtc.dev/oxaide/apis/oxaide-brief-api.md) · [All operations](https://skmtc.dev/oxaide/apis/oxaide-brief-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxaide/apis/oxaide-brief-api/revisions/9b4716a885b5?raw)