Creates a new 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",
"user_id": 123,
"details": "<string>"
}
}
}'
{
"data": {
"id": "906e2639-fa4b-47e1-9008-f3be99c036df",
"type": "alert_events",
"attributes": {
"kind": "note",
"source": "api",
"action": "created",
"details": "This is a test note",
"user": {
"id": 6,
"email": "bot@rootly.com",
"deleted_at": null,
"created_at": "2025-07-23T05:25:11.139-07:00",
"updated_at": "2025-07-23T05:25:11.139-07:00",
"current_team_id": 2,
"first_name": "Rootly",
"last_name": null,
"time_zone": "America/Los_Angeles",
"last_seen_at": null,
"profile_photo_id": null,
"ability_cache": null,
"last_notification_email_sent_at": null,
"accept_terms": true,
"onboarding_completed": true,
"service_user": true,
"accept_marketing": true,
"teams_count": 1,
"created_through_sso": false,
"scim_uid": null,
"session_token": null,
"incidents_example_count": 0,
"incidents_test_count": 0,
"incidents_normal_count": 0,
"incidents_scheduled_count": 0,
"incidents_backfilled_count": 0,
"incidents_count": 0,
"theme": "light_v2",
"skip_tutorial": false,
"external_id": null,
"jti": "c587bf54-d639-462f-904c-67998671817d",
"is_super_admin": false,
"has_impersonate_write_permission": false,
"view_multiple_schedules": true,
"push_notification_new_alert_sound": "default",
"push_notification_shift_starts_sound": "soft_bloob",
"push_notification_shift_ends_sound": "soft_bloob",
"how_did_you_hear_about_us": null,
"push_notification_new_alert_volume": 1,
"opsgenie_id": null,
"victor_ops_id": null,
"pagerduty_id": null,
"locale": "en"
},
"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-07-23T05:25:12.288-07:00",
"updated_at": "2025-07-23T05:25:12.288-07:00"
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
alert event created with Rootly bot user
The response is of type object
.
Was this page helpful?
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",
"user_id": 123,
"details": "<string>"
}
}
}'
{
"data": {
"id": "906e2639-fa4b-47e1-9008-f3be99c036df",
"type": "alert_events",
"attributes": {
"kind": "note",
"source": "api",
"action": "created",
"details": "This is a test note",
"user": {
"id": 6,
"email": "bot@rootly.com",
"deleted_at": null,
"created_at": "2025-07-23T05:25:11.139-07:00",
"updated_at": "2025-07-23T05:25:11.139-07:00",
"current_team_id": 2,
"first_name": "Rootly",
"last_name": null,
"time_zone": "America/Los_Angeles",
"last_seen_at": null,
"profile_photo_id": null,
"ability_cache": null,
"last_notification_email_sent_at": null,
"accept_terms": true,
"onboarding_completed": true,
"service_user": true,
"accept_marketing": true,
"teams_count": 1,
"created_through_sso": false,
"scim_uid": null,
"session_token": null,
"incidents_example_count": 0,
"incidents_test_count": 0,
"incidents_normal_count": 0,
"incidents_scheduled_count": 0,
"incidents_backfilled_count": 0,
"incidents_count": 0,
"theme": "light_v2",
"skip_tutorial": false,
"external_id": null,
"jti": "c587bf54-d639-462f-904c-67998671817d",
"is_super_admin": false,
"has_impersonate_write_permission": false,
"view_multiple_schedules": true,
"push_notification_new_alert_sound": "default",
"push_notification_shift_starts_sound": "soft_bloob",
"push_notification_shift_ends_sound": "soft_bloob",
"how_did_you_hear_about_us": null,
"push_notification_new_alert_volume": 1,
"opsgenie_id": null,
"victor_ops_id": null,
"pagerduty_id": null,
"locale": "en"
},
"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-07-23T05:25:12.288-07:00",
"updated_at": "2025-07-23T05:25:12.288-07:00"
}
}
}