Skip to main content
POST
/
v1
/
alerts
/
{alert_id}
/
events
Create alert event
curl --request POST \
  --url https://api.rootly.com/v1/alerts/{alert_id}/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "alert_events",
    "attributes": {
      "kind": "note",
      "details": "<string>",
      "user_id": 123
    }
  }
}
'
{
  "data": {
    "id": "bcec8ea3-edce-4f7b-bfec-2ae885f26afe",
    "type": "alert_events",
    "attributes": {
      "kind": "note",
      "source": "api",
      "action": "created",
      "details": "This is a test note",
      "user": {
        "id": 6,
        "ability_cache": null,
        "accept_marketing": true,
        "accept_terms": true,
        "created_at": "2025-12-10T16:19:09.953-08:00",
        "created_through_sso": false,
        "current_team_id": 2,
        "deleted_at": null,
        "email": "[email protected]",
        "external_id": null,
        "first_name": "Rootly",
        "has_impersonate_write_permission": false,
        "how_did_you_hear_about_us": null,
        "incidents_backfilled_count": 0,
        "incidents_count": 0,
        "incidents_example_count": 0,
        "incidents_normal_count": 0,
        "incidents_scheduled_count": 0,
        "incidents_test_count": 0,
        "is_super_admin": false,
        "jti": "51beb98f-ec77-4168-b42e-3936a71c6560",
        "last_name": null,
        "last_notification_email_sent_at": null,
        "last_seen_at": null,
        "locale": "en",
        "onboarding_completed": true,
        "opsgenie_id": null,
        "pagerduty_id": null,
        "profile_photo_id": null,
        "push_notification_new_alert_sound": "default",
        "push_notification_new_alert_volume": 1,
        "push_notification_shift_ends_sound": "soft_bloob",
        "push_notification_shift_starts_sound": "soft_bloob",
        "scim_uid": null,
        "service_user": true,
        "session_token": null,
        "skip_tutorial": false,
        "teams_count": 1,
        "theme": "light_v2",
        "time_zone": "America/Los_Angeles",
        "updated_at": "2025-12-10T16:19:09.953-08:00",
        "victor_ops_id": null,
        "view_multiple_schedules": true
      },
      "user_id": 6,
      "incident": null,
      "schedule": null,
      "escalation_level": null,
      "escalation_target_type": null,
      "escalation_target": null,
      "slack_channel": null,
      "incident_ids": [],
      "created_at": "2025-12-10T16:19:10.495-08:00",
      "updated_at": "2025-12-10T16:19:10.495-08:00"
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
alert_id
string
required

Body

application/vnd.api+json
​
data
object
required

Response

alert event created with Rootly bot user

​
data
object
required