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": "3187e339-f8c8-41cd-8850-d208759e7457",
"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-08-12T10:43:19.448-07:00",
"created_through_sso": false,
"current_team_id": 2,
"deleted_at": null,
"email": "bot@rootly.com",
"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": "97e424dc-4d6b-45be-8d04-b0ab1f5be0bb",
"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-08-12T10:43:19.448-07: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-08-12T10:43:20.480-07:00",
"updated_at": "2025-08-12T10:43:20.480-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": "3187e339-f8c8-41cd-8850-d208759e7457",
"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-08-12T10:43:19.448-07:00",
"created_through_sso": false,
"current_team_id": 2,
"deleted_at": null,
"email": "bot@rootly.com",
"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": "97e424dc-4d6b-45be-8d04-b0ab1f5be0bb",
"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-08-12T10:43:19.448-07: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-08-12T10:43:20.480-07:00",
"updated_at": "2025-08-12T10:43:20.480-07:00"
}
}
}