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": {
      "enabled_contact_types": [
        "email"
      ],
      "delay": 123,
      "position": 123,
      "user_email_address_id": "<string>",
      "user_call_number_id": "<string>",
      "user_sms_number_id": "<string>",
      "user_device_id": "<string>"
    }
  }
}
'
{
  "data": {
    "id": "f6188309-9f5b-41b4-83e8-2db3a21c3e22",
    "type": "user_notification_rules",
    "attributes": {
      "user_id": 1051,
      "delay": 2,
      "position": 1,
      "user_email_address_id": "2e1be30f-58ca-4af4-8cca-516bdaa3f0e7",
      "user_call_number_id": "4217b9c6-b0e7-4d0b-8a82-ec057675e973",
      "user_sms_number_id": "4217b9c6-b0e7-4d0b-8a82-ec057675e973",
      "user_device_id": "2df184b7-724e-4e02-956f-2409e531e82f",
      "enabled_contact_types": [
        "email"
      ],
      "notification_type": "quiet",
      "created_at": "2026-01-31T09:20:21.938-08:00",
      "updated_at": "2026-01-31T09:20:21.938-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