v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
On-Call

Create an On-Call notification channel for a user

Create a new notification channel for a user. The authenticated user must be the target user or have the on_call_admin permission

post/api/v2/on-call/users/{user_id}/notification-channels

Path parameters

user_idstring required
Example:00000000-0000-0000-0000-000000000000

The user ID

Request body

Example request

{
  "data": {
    "attributes": {
      "config": {
        "address": "foo@bar.com",
        "formats": [
          "html"
        ],
        "type": "email"
      }
    },
    "type": "notification_channels"
  }
}

Response

Created

Example response

{
  "data": {
    "attributes": {
      "config": {
        "address": "foo@bar.com",
        "formats": [
          "html"
        ],
        "type": "email"
      }
    },
    "id": "27590dae-47be-4a7d-9abf-8f4e45124020",
    "type": "notification_channels"
  }
}