Skip to main content
POST
/
v1
/
users
/
{user_id}
/
notification_rules
Creates an user notification rule
curl --request POST \
  --url https://api.rootly.com/v1/users/{user_id}/notification_rules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "user_notification_rules",
    "attributes": {
      "delay": 123,
      "position": 123,
      "user_email_address_id": "<string>",
      "user_call_number_id": "<string>",
      "user_sms_number_id": "<string>",
      "user_device_id": "<string>",
      "enabled_contact_types": [
        "email"
      ]
    }
  }
}'
{
  "data": {
    "id": "3edd2a4b-df12-4627-90a1-f4c1838181e4",
    "type": "user_notification_rules",
    "attributes": {
      "user_id": 557,
      "delay": 2,
      "position": 1,
      "user_email_address_id": "4b5722b9-e748-4183-8f62-9bf5baf2bc6f",
      "user_call_number_id": "4d501c16-d654-47e7-8373-04aae27fed8a",
      "user_sms_number_id": "4d501c16-d654-47e7-8373-04aae27fed8a",
      "user_device_id": "548a4104-c89f-4ab2-9c0d-9380bf5d1260",
      "enabled_contact_types": [
        "email"
      ],
      "created_at": "2025-10-28T10:28:34.402-07:00",
      "updated_at": "2025-10-28T10:28:34.402-07:00"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
user_id
string
required

Body

application/vnd.api+json
​
data
object
required

Response

user_notification_rule created

​
data
object
required