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": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-09-08T13:44:07.667-07:00",
"updated_at": "2025-09-08T13:44:07.667-07:00",
"communication_type_id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
"communication_type": {
"data": {
"id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
"type": "communications_types",
"attributes": {
"name": "uzzrc",
"slug": "uzzrc",
"description": "Eveniet fuga expedita velit.",
"color": "#D7E7F5",
"position": 1,
"created_at": "2025-09-08T13:44:05.757-07:00",
"updated_at": "2025-09-08T13:44:05.757-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "47e63ac5-debf-4c80-ac1a-fdbbb2cd0e77",
"name": "v5ykr"
},
{
"id": "c34d6371-b6f4-472b-bfe9-9f18c4449ad6",
"name": "t4kl8"
},
{
"id": "91a6bd76-94f4-4df9-b1dc-e28eb289094f",
"name": "i3af0"
},
{
"id": "91dca44a-e53b-489b-9a43-dc1fa84c4152",
"name": "kk5yj"
},
{
"id": "29f909c1-b3d8-4a92-a620-e73ad8389d49",
"name": "6ti7b"
},
{
"id": "df202f71-e980-483a-a774-52a65616547a",
"name": "pnwki"
},
{
"id": "dc7adc38-488c-4c53-8cb0-244c7e04d4f7",
"name": "xi142"
},
{
"id": "0fb51f90-852b-460c-b6b9-8fc96f792732",
"name": "mpxoj"
},
{
"id": "4055724f-ed72-40da-83f8-4aa6825ddf93",
"name": "3r6m0"
},
{
"id": "2918e189-e869-4a67-9215-16f1d9ba12fb",
"name": "96279"
},
{
"id": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
"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": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-09-08T13:44:07.667-07:00",
"updated_at": "2025-09-08T13:44:07.667-07:00",
"communication_type_id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
"communication_type": {
"data": {
"id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
"type": "communications_types",
"attributes": {
"name": "uzzrc",
"slug": "uzzrc",
"description": "Eveniet fuga expedita velit.",
"color": "#D7E7F5",
"position": 1,
"created_at": "2025-09-08T13:44:05.757-07:00",
"updated_at": "2025-09-08T13:44:05.757-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "47e63ac5-debf-4c80-ac1a-fdbbb2cd0e77",
"name": "v5ykr"
},
{
"id": "c34d6371-b6f4-472b-bfe9-9f18c4449ad6",
"name": "t4kl8"
},
{
"id": "91a6bd76-94f4-4df9-b1dc-e28eb289094f",
"name": "i3af0"
},
{
"id": "91dca44a-e53b-489b-9a43-dc1fa84c4152",
"name": "kk5yj"
},
{
"id": "29f909c1-b3d8-4a92-a620-e73ad8389d49",
"name": "6ti7b"
},
{
"id": "df202f71-e980-483a-a774-52a65616547a",
"name": "pnwki"
},
{
"id": "dc7adc38-488c-4c53-8cb0-244c7e04d4f7",
"name": "xi142"
},
{
"id": "0fb51f90-852b-460c-b6b9-8fc96f792732",
"name": "mpxoj"
},
{
"id": "4055724f-ed72-40da-83f8-4aa6825ddf93",
"name": "3r6m0"
},
{
"id": "2918e189-e869-4a67-9215-16f1d9ba12fb",
"name": "96279"
},
{
"id": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}