---
title: "Create notification config"
method: POST
path: "/api/v1/circuit-breaker/notifications"
tags: ["Circuit Breaker"]
---

# Create notification config

`POST /api/v1/circuit-breaker/notifications`

## Request

- Base URL: `https://agent.getaxonflow.com`
- URL: `https://agent.getaxonflow.com/api/v1/circuit-breaker/notifications`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/docs/api/v1/circuit-breaker/notifications/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a notification channel for circuit breaker auto-trip events.
Supports webhook (HMAC-signed), Slack (Block Kit), and PagerDuty (Events API v2).

## Headers

- `Authorization` string, required

## Request body

- CircuitBreakerNotificationCreate
  - `type` 'webhook' | 'slack' | 'pagerduty', required
  - `url` string, required: Webhook URL, Slack incoming webhook URL, or PagerDuty override URL
  - `secret` string: HMAC secret for webhooks, or PagerDuty routing key
  - `tenant_id` string: Optional tenant filter for notifications
  - `active` boolean

## Response `201`

Notification config created

## Other responses

- `400`: Invalid request body or parameters

---

[API](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api.md) - [All operations](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaxonflow/apis/axonflow-agent-api/revisions/34d30fcb7fa1?raw)