---
title: "Register Webhook"
method: POST
path: "/api/webhooks/register"
tags: ["Agent"]
---

# Register Webhook

`POST /api/webhooks/register`

## Request

- Base URL: `https://alpha-bazaar-signal-server.onrender.com`
- URL: `https://alpha-bazaar-signal-server.onrender.com/api/webhooks/register`
- Auth: HTTP bearer

Register a callback URL for push notifications on signal/confluence events.

The returned secret is shown only once — store it to verify X-AB-Signature headers.

## Response `200`

Successful Response

- WebhookCreateResponse: POST /api/webhooks/register
  - `status` string, required
  - `webhook` WebhookRegistration, required: Webhook details returned on creation (includes secret)
    - `id` string, required
    - `url` string, required
    - `event_types` string[], required
    - `secret` string, required
    - `is_active` boolean
    - `created_at` string, required
  - `next_step` string, nullable

---

[API](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server.md) · [All operations](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/llms.txt) · [OpenAPI document](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/revisions/01654ec03d07?raw)