v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB

Notifications

Add a Notification Setting

Add a notification setting.

post/notification_settings

Request body

associated_record_typestring

associated_record_type_valuestring

created_atstring date-time

ISO 8601 formatted date indicating when the resource was created.

idstring

A UUID.

notification_channel_idstring

A UUID reference to the associated Notification Channel.

notification_event_condition_idstring

A UUID reference to the associated Notification Event Condition.

notification_profile_idstring

A UUID reference to the associated Notification Profile.

Most preferences apply immediately; however, other may needs to propagate.

updated_atstring date-time

ISO 8601 formatted date indicating when the resource was updated.

Example request

{
  "associated_record_type": "phone_number",
  "associated_record_type_value": "+13125550000",
  "created_at": "2019-10-15T10:07:15.527Z",
  "id": "8eb5b5f9-5893-423c-9f15-b487713d44d4",
  "notification_channel_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
  "notification_event_condition_id": "70c7c5cb-dce2-4124-accb-870d39dbe852",
  "notification_profile_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
  "parameters": [
    {
      "name": "phone_number",
      "value": "+13125550000"
    }
  ],
  "status": "enable-received",
  "updated_at": "2019-10-15T10:07:15.527Z"
}

Response

A Notification Setting response

Example response

{
  "data": {
    "associated_record_type": "phone_number",
    "associated_record_type_value": "+13125550000",
    "created_at": "2019-10-15T10:07:15.527Z",
    "id": "8eb5b5f9-5893-423c-9f15-b487713d44d4",
    "notification_channel_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
    "notification_event_condition_id": "70c7c5cb-dce2-4124-accb-870d39dbe852",
    "notification_profile_id": "12455643-3cf1-4683-ad23-1cd32f7d5e0a",
    "parameters": [
      {
        "name": "phone_number",
        "value": "+13125550000"
      }
    ],
    "status": "enable-received",
    "updated_at": "2019-10-15T10:07:15.527Z"
  }
}