Uptimeify Docs
Notification channels

List Notification Channels

Returns notification channels scoped by organization, customer, or website.

GET /api/notification-channels

Query Parameters

ParameterTypeRequiredDescription
organizationIdnumberNoScope to organization
customerIdnumberNoScope to customer
websiteIdnumberNoScope to website (includes org + customer channels)

Example (cURL)

curl -X GET "$BASE_URL/api/notification-channels?organizationId=1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Response

[
  {
    "id": 1,
    "organizationId": 1,
    "customerId": null,
    "websiteId": null,
    "type": "email",
    "category": "direct",
    "name": "Ops Email",
    "config": { "email": "ops@example.com", "to": "Ops Team" },
    "priority": 1,
    "delaySeconds": 0,
    "conditions": null,
    "isActive": true,
    "allowedPackageTypes": null
  }
]

Common errors

  • 401 Unauthorized when not authenticated
  • 403 Forbidden when accessing channels outside your scope

On this page