List notification channels

List all notification channels linked to your account.


GET/api/user/notification-channels

Get all notification channels

This endpoint returns the notification channels of your account, such as Slack, Discord or email. Use the id to attach a channel to a database backup or a site file backup. Webhook URLs and tokens are never included.

Request

GET
/api/user/notification-channels
curl -G "https://ploi.io/api/user/notification-channels" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Response

{
  "data": [
    {
      "id": 12,
      "type": "slack",
      "label": "Ops alerts",
      "created_at": "2026-09-24 10:12:00"
    }
  ],
  "links": {
    "first": "https://ploi.io/api/user/notification-channels?page=1",
    "last": "https://ploi.io/api/user/notification-channels?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://ploi.io/api/user/notification-channels",
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}