---
title: "Add a notification target"
method: POST
path: "/v1/notification-targets"
tags: ["Notifications"]
---

# Add a notification target

`POST /v1/notification-targets`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/notification-targets`
- Auth: HTTP bearer

Where approvals and automation output reach a human: a phone number, an
https webhook, an email address, or a push token.

An SMS target is created **unverified** and stays that way until someone
proves they hold the number. Adding a number must not itself be an
authorisation — otherwise a session borrowed for five minutes leaves
behind a number that can approve things long after it is gone. An
unverified target still receives notifications; it just cannot reply to
decide one.

## Request body

- object
  - `target_type` 'sms' | 'webhook' | 'expo' | 'email', required
  - `config` object, required: `{"phone_number": "+14155550123"}` for sms (E.164 only), `{"url": "https://…"}` for webhook (https only), `{"email": "…"}`, or `{"push_token": "…"}`.
  - `events` string[]: Empty means every event.
  - `agent_id` string, uuid: The agent whose SMS channel sends to this target.
  - `user_id` string, uuid: Defaults to the caller.

## Response `201`

Target created, unverified

- NotificationTarget
  - `id` string, uuid, required
  - `target_type` 'sms' | 'webhook' | 'expo' | 'email', required
  - `user_id` string, uuid, nullable
  - `agent_id` string, uuid, nullable
  - `config` object, required
  - `events` string[], required
  - `is_active` boolean, required
  - `verified` boolean, required: An unverified SMS target receives notifications but cannot decide an approval by reply.
  - `created_at` string, date-time, required

## Other responses

- `400`: Invalid request
- `403`: Insufficient permissions
- `409`: Resource already exists or conflict

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/5fa0918f3b41?raw)