Notifications

Create a notification channel

Changed on

Creates a new notification channel defining where notifications are delivered, and returns the created channel.

post/notification_channels

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/notification_channels
  • Auth: HTTP bearer

Request body

idstring

A UUID.

notification_profile_idstring

A UUID reference to the associated Notification Profile.

channel_type_id'sms' | 'voice' | 'email' | 'webhook'

A Channel Type ID

channel_destinationstring

The destination associated with the channel type.

created_atstring date-time

ISO 8601 formatted date indicating when the resource was created.

updated_atstring date-time

ISO 8601 formatted date indicating when the resource was updated.

Example request

{
  "id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
  "notification_profile_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
  "channel_destination": "+13125550000",
  "created_at": "2019-10-15T10:07:15.527Z",
  "updated_at": "2019-10-15T10:07:15.527Z"
}

Response

A Notification Channel response

Example response

{
  "data": {
    "id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
    "notification_profile_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
    "channel_destination": "+13125550000",
    "created_at": "2019-10-15T10:07:15.527Z",
    "updated_at": "2019-10-15T10:07:15.527Z"
  }
}

Changes

  • 19db5ee4ec59Revision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a6a61a29ecddRevision changes
    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the /// response's property format changed from json-pointer to no format for status

    • breaking

      the /// response's property format changed from json-pointer to no format for status

    • breaking

      the /// response's property format changed from json-pointer to no format for status