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": "6b5f5160-26da-404f-9605-3bdbea52dd38",
    "type": "user_notification_rules",
    "attributes": {
      "user_id": 559,
      "delay": 2,
      "position": 1,
      "user_email_address_id": "faf9c1ed-d55e-439f-8ef7-78bc745452c3",
      "user_call_number_id": "09a86cfe-e1a4-4dd7-8e42-a7e0f3200640",
      "user_sms_number_id": "09a86cfe-e1a4-4dd7-8e42-a7e0f3200640",
      "user_device_id": "1b3c75be-75ad-4e68-988a-d2bb98952a6e",
      "enabled_contact_types": [
        "email"
      ],
      "created_at": "2025-11-14T13:18:52.228-08:00",
      "updated_at": "2025-11-14T13:18:52.228-08: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