Skip to Content
SeyloDocs
API referenceNotifications

Create a notification channel

POST
/api/v1/notifications.createChannel

Adds a channel (email, webhook, Discord, Slack, Telegram, ntfy, Pushover or Gotify) that alert rules can then use.

Needs notifications.manage, which owners and admins hold. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Request Body

application/json
  1. body
name*string
Length1 <= length <= 60
config*|||||||
enabled?boolean
isDefault?boolean

Response Body

Success.

application/json
  1. response
id*string

Panel-issued id.

Match^[a-z0-9]{16}$
name*string
kind*string|string|string|string|string|string|string|string
enabled*boolean
isDefault*boolean
config*|||||||
secretsSet*array<string>
target*string
usedBy*
lastDelivery*|null
createdAt*string
Formatdate-time
updatedAt*string
Formatdate-time
Example Request
curl -X POST 'https://example.com/api/v1/notifications.createChannel' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "config": {    "kind": "smtp",    "host": "string",    "port": 1,    "security": "starttls",    "username": "string",    "from": "[email protected]",    "to": [      "[email protected]"    ]  }}'
Example Response
{  "id": "string",  "name": "string",  "kind": "smtp",  "enabled": true,  "isDefault": true,  "config": {    "kind": "smtp",    "host": "string",    "port": 0,    "security": "starttls",    "username": "string",    "from": "string",    "to": [      "string"    ]  },  "secretsSet": [    "string"  ],  "target": "string",  "usedBy": {    "services": 0,    "defaults": true  },  "lastDelivery": {    "status": "sent",    "at": "2019-08-24T14:15:22Z",    "error": "string"  },  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}

List notification channels GET

Lists every notification channel with a redacted target, which services use it and its last delivery. Secrets are never returned. Any signed-in caller. Available to MCP clients and the assistant.

Get the default alert rules GET

Returns the panel-wide alert rules: which events notify which channels. Services use these unless they set their own; node, update and approval events are only configured here. Any signed-in caller. Available to MCP clients and the assistant.