---
title: "Register Webhook Adapter"
method: POST
path: "/webhook-adapters"
---

# Register Webhook Adapter

`POST /webhook-adapters`

## Request

- Base URL: `https://api-docs.session-exchange.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.session-exchange.com/webhook-adapters`
- Auth: none declared

## Request body

- WebhookAdapterRegisterRequest
  - `adapter_id` string, required
  - `mode` 'direct' | 'enrich'
  - `station` string, required
  - `default_role` 'author' | 'validator' | 'reviewer' | 'approver' | 'merger' | 'observer' | 'system'
  - `auth` WebhookAuth, required
    - `type` 'hmac' | 'basic' | 'bearer' | 'none', required
    - `header` string, nullable
    - `algo` 'sha256' | 'sha1', nullable
    - `prefix` string, nullable
    - `username` string, nullable
    - `secret_name` string, nullable
  - `rules` WebhookRule[], required
    - `id` string, required
    - `when` string, nullable
    - `emit` object
  - `first_match` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/session-exchange/apis/a4sx.md) · [All operations](https://skmtc.dev/session-exchange/apis/a4sx/llms.txt) · [OpenAPI document](https://skmtc.dev/session-exchange/apis/a4sx/revisions/abaefc33dfc7?raw)