---
title: "Admin Upsert Notification"
method: POST
path: "/v1/admin/notifications"
tags: ["admin"]
---

# Admin Upsert Notification

`POST /v1/admin/notifications`

## Request

- Base URL: `https://www.tandem-cc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tandem-cc.com/v1/admin/notifications`
- Auth: none declared

Create or update a notification channel for a handle.

Body:
  {
    "handle":  "brian@tandem-cc.com",   # required
    "kind":    "email",              # required: email | slack | sms | webhook
    "target":  "brian@acme.com",     # required; shape depends on kind
    "enabled": true                  # optional (default true)
  }

Idempotent on (handle, kind, target): re-posting flips `enabled`
if different.

## Headers

- `X-Tandem-Api-Key` string, nullable

## Request body

- object

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tandem-cc/apis/tandem-api.md) · [All operations](https://skmtc.dev/tandem-cc/apis/tandem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tandem-cc/apis/tandem-api/revisions/3b804877b47c?raw)