Create a notification channel

post

https://api.linode.com/{apiVersion}/monitor/alert-channels

Beta Create a new notification channel, to set up a communication method for a monitoring alert. This is referred to as a user channel and you can have a maximum of five on your account.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: monitor:read_write

CLI

linode-cli alerts channels-create
--label Email channel for Managed Database alerts \
--channel_type email \
--details.email.usernames johndoe \
--details.email.usernames janedoe

Learn more

Responses

Response body

object

alerts

object

Details about the alerts where you've applied this notification channel.

alert_count

integer

The number of alerts that have been assigned to this notification channel. This will be 0 for a newly created channel.

type

string

enum

The alert's entity type. This will always be alert-definitions for an alert.

alert-definitions

url

The URL to access a list of all of the alerts assigned to this notification channel, based on its id.

channel_type

string

enum

The type of notification used with the channel. Currently, only email is supported.

email

created

date-time

When the notification channel was created.

created_by

string

For a user notification channel, this is the user on your account that created it. For a system notification channel, this value is returned as system.

details

object

The configuration of the notification channel.

object

A notification channel set up to deliver an email for an alert.

integer

Filterable The unique identifier for the notification channel.

label

string

Filterable The name of the notification channel for identification purposes.

type

string

enum

The type of notification channel. This can be either system for a channel provided by Akamai, or user for one you've created.

system user

updated

date-time

When the notification channel was last updated. This is the same as created if the channel hasn't been updated.

updated_by

string

For a user notification channel, this is the user on your account that last updated it. For a system notification channel, this is returned as system. If it hasn't been updated, this value is the same as created_by.

Language

Credentials


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.linode.com/v4beta/monitor/alert-channels \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "channel_type": "email"
8
}
9
'


xxxxxxxxxx
24
 
1
{
2
  "alerts": {
3
    "alert_count": 5,
4
    "type": "alerts-definitions",
5
    "url": "/monitor/alert-channels/10000/alerts"
6
  },
7
  "channel_type": "email",
8
  "created": "2026-01-20 01:41:09",
9
  "created_by": "johndoe",
10
  "details": {
11
    "email": {
12
      "recipient_type": "user",
13
      "usernames": [
14
        "johndoe",
15
        "janedoe"
16
      ]
17
    }
18
  },
19
  "id": 10000,
20
  "label": "Email channel for Managed Database alerts",
21
  "type": "user",
22
  "updated": "2026-01-20 01:41:09",
23
  "updated_by": "johndoe"
24
}

200A notification channel was created.

defaultSee Errors for the range of possible error response codes.