Skip to main content
POST
/
notifications
/
api
/
v1
/
notifications
/
channels
Create a notification channel
curl --request POST \
  --url https://www.closient.com/notifications/api/v1/notifications/channels \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "label": "<string>",
  "config": {}
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "label": "<string>",
  "verified": true,
  "enabled": true
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Request body to register a new notification channel for the authenticated user.

The newly-created channel is always returned with verified=False; a follow-up verification flow (email link, SMS code) must complete before the channel will receive notifications.

​
channel_type
enum<string>
required

Delivery channel to register. Determines which keys config must contain.

Available options:
email,
sms,
in_app
​
label
string
required

User-friendly label for this channel. Shown in the channel-management UI.

Maximum string length: 100
​
config
Config · object

Channel-specific configuration. Required keys depend on channel_type: email requires email (RFC 5322 address); sms requires phone_number (E.164); in_app accepts an empty object.

Response

Created

A user-owned notification channel (email address, SMS number, in-app inbox).

Each user may register multiple channels of the same type — for example, a personal and a work email. Returned by all channel endpoints.

​
id
string<uuid>
required

Unique channel identifier (UUIDv4).

​
channel_type
enum<string>
required

Delivery channel for this contact point. email and sms deliver out-of-band; in_app is rendered in the user's notification center.

Available options:
email,
sms,
in_app
​
label
string
required

User-assigned label that disambiguates channels of the same type (e.g. Work Email vs Personal Email).

Maximum string length: 100
​
verified
boolean
required

Whether the user has confirmed ownership of this channel (e.g. clicked a verification link or replied to an SMS code). Unverified channels do not receive notifications.

​
enabled
boolean
required

Whether notifications are currently delivered to this channel. Set to false to pause delivery without deleting the channel.