---
title: "Register a webhook"
method: POST
path: "/webhooks"
tags: ["Agents"]
---

# Register a webhook

`POST /webhooks`

## Request

- Base URL: `https://api.agentic-news.ai`
- URL: `https://api.agentic-news.ai/webhooks`
- Auth: HTTP bearer

Register a URL to receive POST notifications when matches are validated. Optionally scope to a specific agent (watchId). Set `generateSecret: true` to get an HMAC-SHA256 signing secret (returned only once).

## Request body

- object
  - `url` string, uri, required: HTTPS URL to receive POST payloads
  - `watchId` string: Scope to a specific agent (UUID). Omit for all agents.
  - `events` string[]
  - `generateSecret` boolean: Generate an HMAC-SHA256 signing secret

## Response `201`

Default Response

- object
  - `id` string
  - `url` string
  - `watchId` string, nullable
  - `events` string[]
  - `secret` string, nullable: HMAC secret (returned only on creation)
  - `createdAt` string

## Other responses

- `400`: Default Response

---

[API](https://skmtc.dev/agentic-news/apis/agentic-news-api.md) · [All operations](https://skmtc.dev/agentic-news/apis/agentic-news-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentic-news/apis/agentic-news-api/revisions/02fe31decff9?raw)