Creates a new team from provided data
curl --request POST \
--url https://api.rootly.com/v1/teams \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "groups",
"attributes": {
"name": "<string>",
"description": "<string>",
"notify_emails": [
"<string>"
],
"color": "<string>",
"position": 123,
"backstage_id": "<string>",
"external_id": "<string>",
"pagerduty_id": "<string>",
"pagerduty_service_id": "<string>",
"opsgenie_id": "<string>",
"opsgenie_team_id": "<string>",
"victor_ops_id": "<string>",
"pagertree_id": "<string>",
"cortex_id": "<string>",
"service_now_ci_sys_id": "<string>",
"user_ids": [
123
],
"admin_ids": [
123
],
"alerts_email_enabled": true,
"alert_urgency_id": "<string>",
"slack_channels": [
{
"id": "<string>",
"name": "<string>"
}
],
"slack_aliases": [
{
"id": "<string>",
"name": "<string>"
}
],
"alert_broadcast_enabled": true,
"alert_broadcast_channel": {
"id": "<string>",
"name": "<string>"
},
"incident_broadcast_enabled": true,
"incident_broadcast_channel": {
"id": "<string>",
"name": "<string>"
},
"auto_add_members_when_attached": true
}
}
}
'{
"data": {
"id": "e1714972-4bcf-449b-875c-e3197ec26743",
"type": "groups",
"attributes": {
"slug": "infrastructure",
"name": "Infrastructure",
"description": "Everything infrastructure related",
"color": "#FFF",
"position": 1,
"notify_emails": [
"[email protected]",
"[email protected]"
],
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "infrastructure"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "infrastructure"
}
],
"pagerduty_id": "PQ9K7I8",
"pagerduty_service_id": null,
"backstage_id": null,
"external_id": "d795fe69-acc2-4b30-92c9-3c25cbb92056",
"opsgenie_id": "8743a1b2-11da-480e-8493-744660987bef",
"victor_ops_id": "e877c558-12e2-44d2-8723-5c86f7473c54",
"pagertree_id": "daa8bcd6-bf4a-4716-976c-812832ae115e",
"cortex_id": null,
"service_now_ci_sys_id": null,
"user_ids": [
598,
599
],
"admin_ids": [],
"incidents_count": 0,
"alert_urgency_id": null,
"alerts_email_enabled": true,
"alerts_email_address": "[email protected]",
"alert_broadcast_enabled": true,
"alert_broadcast_channel": {
"id": "C123ALERT",
"name": "team-alerts"
},
"incident_broadcast_enabled": true,
"incident_broadcast_channel": {
"id": "C123INCIDENT",
"name": "team-incidents"
},
"auto_add_members_when_attached": true,
"created_at": "2025-12-07T23:50:58.923-08:00",
"updated_at": "2025-12-07T23:50:58.928-08:00"
},
"relationships": {
"users": {
"data": [
{
"id": "598",
"type": "users"
},
{
"id": "599",
"type": "users"
}
]
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
groups Show child attributes
The name of the team
The description of the team
Emails to attach to the team
The hex color of the team
Position of the team
The Backstage entity id associated to this team. eg: :namespace/:kind/:entity_name
The external id associated to this team
The PagerDuty group id associated to this team
The PagerDuty service id associated to this team
The Opsgenie group id associated to this team
The Opsgenie team id associated to this team
The VictorOps group id associated to this team
The PagerTree group id associated to this team
The Cortex group id associated to this team
The Service Now CI sys id associated to this team
The user ids of the members of this team.
The user ids of the admins of this team. These users must also be present in user_ids attribute.
Enable alerts through email
The alert urgency id of the team
Enable alerts to be broadcasted to a specific channel
Enable incidents to be broadcasted to a specific channel
Auto add members to incident channel when team is attached
team created
Show child attributes
Unique ID of the team
groups Show child attributes
The name of the team
Date of creation
Date of last update
The description of the team
Emails to attach to the team
The hex color of the team
Position of the team
The Backstage entity id associated to this team. eg: :namespace/:kind/:entity_name
The external id associated to this team
The PagerDuty group id associated to this team
The PagerDuty service id associated to this team
The Opsgenie group id associated to this team
The VictorOps group id associated to this team
The PagerTree group id associated to this team
The Cortex group id associated to this team
The Service Now CI sys id associated to this team
The user ids of the members of this team.
The user ids of the admins of this team. These users must also be present in user_ids attribute.
Enable alerts through email
Email generated to send alerts to
The alert urgency id of the team
Enable alerts to be broadcasted to a specific channel
Enable incidents to be broadcasted to a specific channel
Auto add members to incident channel when team is attached
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/teams \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "groups",
"attributes": {
"name": "<string>",
"description": "<string>",
"notify_emails": [
"<string>"
],
"color": "<string>",
"position": 123,
"backstage_id": "<string>",
"external_id": "<string>",
"pagerduty_id": "<string>",
"pagerduty_service_id": "<string>",
"opsgenie_id": "<string>",
"opsgenie_team_id": "<string>",
"victor_ops_id": "<string>",
"pagertree_id": "<string>",
"cortex_id": "<string>",
"service_now_ci_sys_id": "<string>",
"user_ids": [
123
],
"admin_ids": [
123
],
"alerts_email_enabled": true,
"alert_urgency_id": "<string>",
"slack_channels": [
{
"id": "<string>",
"name": "<string>"
}
],
"slack_aliases": [
{
"id": "<string>",
"name": "<string>"
}
],
"alert_broadcast_enabled": true,
"alert_broadcast_channel": {
"id": "<string>",
"name": "<string>"
},
"incident_broadcast_enabled": true,
"incident_broadcast_channel": {
"id": "<string>",
"name": "<string>"
},
"auto_add_members_when_attached": true
}
}
}
'{
"data": {
"id": "e1714972-4bcf-449b-875c-e3197ec26743",
"type": "groups",
"attributes": {
"slug": "infrastructure",
"name": "Infrastructure",
"description": "Everything infrastructure related",
"color": "#FFF",
"position": 1,
"notify_emails": [
"[email protected]",
"[email protected]"
],
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "infrastructure"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "infrastructure"
}
],
"pagerduty_id": "PQ9K7I8",
"pagerduty_service_id": null,
"backstage_id": null,
"external_id": "d795fe69-acc2-4b30-92c9-3c25cbb92056",
"opsgenie_id": "8743a1b2-11da-480e-8493-744660987bef",
"victor_ops_id": "e877c558-12e2-44d2-8723-5c86f7473c54",
"pagertree_id": "daa8bcd6-bf4a-4716-976c-812832ae115e",
"cortex_id": null,
"service_now_ci_sys_id": null,
"user_ids": [
598,
599
],
"admin_ids": [],
"incidents_count": 0,
"alert_urgency_id": null,
"alerts_email_enabled": true,
"alerts_email_address": "[email protected]",
"alert_broadcast_enabled": true,
"alert_broadcast_channel": {
"id": "C123ALERT",
"name": "team-alerts"
},
"incident_broadcast_enabled": true,
"incident_broadcast_channel": {
"id": "C123INCIDENT",
"name": "team-incidents"
},
"auto_add_members_when_attached": true,
"created_at": "2025-12-07T23:50:58.923-08:00",
"updated_at": "2025-12-07T23:50:58.928-08:00"
},
"relationships": {
"users": {
"data": [
{
"id": "598",
"type": "users"
},
{
"id": "599",
"type": "users"
}
]
}
}
}
}