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": "87cc76e2-b885-4481-a28e-bc111741598b",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-07-30T02:08:42.398-07:00",
"updated_at": "2025-07-30T02:08:42.398-07:00",
"communication_type_id": "14daa193-e534-4f9b-b238-d369cb8e41d5",
"communication_type": {
"data": {
"id": "14daa193-e534-4f9b-b238-d369cb8e41d5",
"type": "communications_types",
"attributes": {
"name": "guljw",
"slug": "guljw",
"description": "Rem labore doloribus est.",
"color": "#F5D9C4",
"position": 1,
"created_at": "2025-07-30T02:08:40.275-07:00",
"updated_at": "2025-07-30T02:08:40.275-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "0fe48e6c-a63e-49a7-bdf9-624c0368918c",
"name": "8idtq"
},
{
"id": "ad1b12e3-76af-42d9-b810-16aa39beffd7",
"name": "scoqh"
},
{
"id": "ad128571-229c-40b4-9d93-74a82a401dfc",
"name": "ttde5"
},
{
"id": "59f49ed5-b02b-4172-bf7e-9e05368c51c1",
"name": "n9s5t"
},
{
"id": "32c758f4-d88f-49d2-a0f3-143c89189b1b",
"name": "mz90h"
},
{
"id": "bb6c1386-69ff-434d-86c9-96f394df23db",
"name": "lq3u6"
},
{
"id": "f7949229-4057-43a5-9824-8fad7983f733",
"name": "mpkzc"
},
{
"id": "70aae744-9fe2-4e23-8611-7c28efa85648",
"name": "nrmdd"
},
{
"id": "010d9c35-6753-4239-91d4-47f5d7419c0f",
"name": "ear6b"
},
{
"id": "497e0359-5cc6-4466-b6ad-2ace7fc6dbe1",
"name": "n6b2m"
},
{
"id": "87cc76e2-b885-4481-a28e-bc111741598b",
"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": "87cc76e2-b885-4481-a28e-bc111741598b",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-07-30T02:08:42.398-07:00",
"updated_at": "2025-07-30T02:08:42.398-07:00",
"communication_type_id": "14daa193-e534-4f9b-b238-d369cb8e41d5",
"communication_type": {
"data": {
"id": "14daa193-e534-4f9b-b238-d369cb8e41d5",
"type": "communications_types",
"attributes": {
"name": "guljw",
"slug": "guljw",
"description": "Rem labore doloribus est.",
"color": "#F5D9C4",
"position": 1,
"created_at": "2025-07-30T02:08:40.275-07:00",
"updated_at": "2025-07-30T02:08:40.275-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "0fe48e6c-a63e-49a7-bdf9-624c0368918c",
"name": "8idtq"
},
{
"id": "ad1b12e3-76af-42d9-b810-16aa39beffd7",
"name": "scoqh"
},
{
"id": "ad128571-229c-40b4-9d93-74a82a401dfc",
"name": "ttde5"
},
{
"id": "59f49ed5-b02b-4172-bf7e-9e05368c51c1",
"name": "n9s5t"
},
{
"id": "32c758f4-d88f-49d2-a0f3-143c89189b1b",
"name": "mz90h"
},
{
"id": "bb6c1386-69ff-434d-86c9-96f394df23db",
"name": "lq3u6"
},
{
"id": "f7949229-4057-43a5-9824-8fad7983f733",
"name": "mpkzc"
},
{
"id": "70aae744-9fe2-4e23-8611-7c28efa85648",
"name": "nrmdd"
},
{
"id": "010d9c35-6753-4239-91d4-47f5d7419c0f",
"name": "ear6b"
},
{
"id": "497e0359-5cc6-4466-b6ad-2ace7fc6dbe1",
"name": "n6b2m"
},
{
"id": "87cc76e2-b885-4481-a28e-bc111741598b",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}