Creates a new communications template from provided data
curl --request POST \
--url https://api.rootly.com/v1/communications/templates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "communications-templates",
"attributes": {
"name": "<string>",
"description": "<string>",
"communication_type_id": "<string>",
"position": 123,
"communication_template_stages_attributes": [
{
"communication_stage_id": "<string>",
"sms_content": "<string>",
"email_subject": "<string>",
"email_body": "<string>",
"slack_content": "<string>"
}
]
}
}
}'
{
"data": {
"id": "0f9ca990-5e92-40e6-bba1-b0351d948a59",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-08-19T10:19:09.846-07:00",
"updated_at": "2025-08-19T10:19:09.846-07:00",
"communication_type_id": "c7105091-cdbc-4169-b2ca-f1c7bfbb2e32",
"communication_type": {
"data": {
"id": "c7105091-cdbc-4169-b2ca-f1c7bfbb2e32",
"type": "communications_types",
"attributes": {
"name": "7l9ud",
"slug": "7l9ud",
"description": "Assumenda hic aut labore.",
"color": "#F4CFD1",
"position": 1,
"created_at": "2025-08-19T10:19:07.777-07:00",
"updated_at": "2025-08-19T10:19:07.777-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "5af5a741-0c99-45fd-b13d-d5a0caed37e1",
"name": "an2dw"
},
{
"id": "73bf68c8-2d08-4169-907e-b6fec2eb8d6b",
"name": "r09w5"
},
{
"id": "692d7e81-8e4e-4def-8bab-3254528bafc2",
"name": "21kap"
},
{
"id": "c0dab2ed-6cb7-45c9-8d3f-01bfed259d8b",
"name": "pzf4b"
},
{
"id": "8289b13c-898f-4d2a-bfab-814f9b149e56",
"name": "8ih1d"
},
{
"id": "a27960ca-fa04-43ac-a9c3-0db0af1e117d",
"name": "9ahhk"
},
{
"id": "d34f0478-4c62-41d6-884d-f9c49b05615b",
"name": "etl5k"
},
{
"id": "c3315937-a297-4475-bba3-3fd21f5eafb5",
"name": "u2il4"
},
{
"id": "d7cf8760-77df-42d1-b8fb-b3a65d0885a9",
"name": "g9r28"
},
{
"id": "afa8cd1e-5e1f-4928-9119-c2b6b674dacb",
"name": "sirfq"
},
{
"id": "0f9ca990-5e92-40e6-bba1-b0351d948a59",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
communications template created
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/communications/templates \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "communications-templates",
"attributes": {
"name": "<string>",
"description": "<string>",
"communication_type_id": "<string>",
"position": 123,
"communication_template_stages_attributes": [
{
"communication_stage_id": "<string>",
"sms_content": "<string>",
"email_subject": "<string>",
"email_body": "<string>",
"slack_content": "<string>"
}
]
}
}
}'
{
"data": {
"id": "0f9ca990-5e92-40e6-bba1-b0351d948a59",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-08-19T10:19:09.846-07:00",
"updated_at": "2025-08-19T10:19:09.846-07:00",
"communication_type_id": "c7105091-cdbc-4169-b2ca-f1c7bfbb2e32",
"communication_type": {
"data": {
"id": "c7105091-cdbc-4169-b2ca-f1c7bfbb2e32",
"type": "communications_types",
"attributes": {
"name": "7l9ud",
"slug": "7l9ud",
"description": "Assumenda hic aut labore.",
"color": "#F4CFD1",
"position": 1,
"created_at": "2025-08-19T10:19:07.777-07:00",
"updated_at": "2025-08-19T10:19:07.777-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "5af5a741-0c99-45fd-b13d-d5a0caed37e1",
"name": "an2dw"
},
{
"id": "73bf68c8-2d08-4169-907e-b6fec2eb8d6b",
"name": "r09w5"
},
{
"id": "692d7e81-8e4e-4def-8bab-3254528bafc2",
"name": "21kap"
},
{
"id": "c0dab2ed-6cb7-45c9-8d3f-01bfed259d8b",
"name": "pzf4b"
},
{
"id": "8289b13c-898f-4d2a-bfab-814f9b149e56",
"name": "8ih1d"
},
{
"id": "a27960ca-fa04-43ac-a9c3-0db0af1e117d",
"name": "9ahhk"
},
{
"id": "d34f0478-4c62-41d6-884d-f9c49b05615b",
"name": "etl5k"
},
{
"id": "c3315937-a297-4475-bba3-3fd21f5eafb5",
"name": "u2il4"
},
{
"id": "d7cf8760-77df-42d1-b8fb-b3a65d0885a9",
"name": "g9r28"
},
{
"id": "afa8cd1e-5e1f-4928-9119-c2b6b674dacb",
"name": "sirfq"
},
{
"id": "0f9ca990-5e92-40e6-bba1-b0351d948a59",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}