Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/vnd.api+json
Response
communications template created
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": "78036116-507e-4969-939e-7fc9683a73f9",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-10-20T08:28:20.394-07:00",
"updated_at": "2025-10-20T08:28:20.394-07:00",
"communication_type_id": "6b09eddc-7465-447b-a116-e4d54b550c75",
"communication_type": {
"data": {
"id": "6b09eddc-7465-447b-a116-e4d54b550c75",
"type": "communications_types",
"attributes": {
"name": "6624k",
"slug": "6624k",
"description": "Ut possimus eos ipsa.",
"color": "#D7E7F5",
"position": 1,
"created_at": "2025-10-20T08:28:18.730-07:00",
"updated_at": "2025-10-20T08:28:18.730-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "d6556f11-d2e3-43e4-aac0-97dfe1a688d4",
"name": "x10of"
},
{
"id": "d1b12d83-3e53-4b28-aa75-a7d96ae8b9a6",
"name": "zby7k"
},
{
"id": "ef9d70dc-c2b1-443d-b30a-1a478d49995e",
"name": "bf2oe"
},
{
"id": "48a7fca2-d72f-4b89-bf05-977a2f4d75b2",
"name": "i7dr7"
},
{
"id": "c6757810-167f-490b-83f0-05eb92557f40",
"name": "rciux"
},
{
"id": "aa0bfe53-925c-4f0c-b46b-37bb01170296",
"name": "kprjh"
},
{
"id": "a02f1acf-52e1-43ce-be94-69c521eec1c5",
"name": "51b99"
},
{
"id": "ad082292-5ffb-4b49-882a-1a9344ff8f09",
"name": "4xvd4"
},
{
"id": "e6ff5676-1318-42b1-a81b-43679917f65a",
"name": "khmna"
},
{
"id": "dceb28c1-3ca9-4ca5-994c-2dbab25764a4",
"name": "0kwxf"
},
{
"id": "78036116-507e-4969-939e-7fc9683a73f9",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Show child attributes
communications template created
Show child attributes
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": "78036116-507e-4969-939e-7fc9683a73f9",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-10-20T08:28:20.394-07:00",
"updated_at": "2025-10-20T08:28:20.394-07:00",
"communication_type_id": "6b09eddc-7465-447b-a116-e4d54b550c75",
"communication_type": {
"data": {
"id": "6b09eddc-7465-447b-a116-e4d54b550c75",
"type": "communications_types",
"attributes": {
"name": "6624k",
"slug": "6624k",
"description": "Ut possimus eos ipsa.",
"color": "#D7E7F5",
"position": 1,
"created_at": "2025-10-20T08:28:18.730-07:00",
"updated_at": "2025-10-20T08:28:18.730-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "d6556f11-d2e3-43e4-aac0-97dfe1a688d4",
"name": "x10of"
},
{
"id": "d1b12d83-3e53-4b28-aa75-a7d96ae8b9a6",
"name": "zby7k"
},
{
"id": "ef9d70dc-c2b1-443d-b30a-1a478d49995e",
"name": "bf2oe"
},
{
"id": "48a7fca2-d72f-4b89-bf05-977a2f4d75b2",
"name": "i7dr7"
},
{
"id": "c6757810-167f-490b-83f0-05eb92557f40",
"name": "rciux"
},
{
"id": "aa0bfe53-925c-4f0c-b46b-37bb01170296",
"name": "kprjh"
},
{
"id": "a02f1acf-52e1-43ce-be94-69c521eec1c5",
"name": "51b99"
},
{
"id": "ad082292-5ffb-4b49-882a-1a9344ff8f09",
"name": "4xvd4"
},
{
"id": "e6ff5676-1318-42b1-a81b-43679917f65a",
"name": "khmna"
},
{
"id": "dceb28c1-3ca9-4ca5-994c-2dbab25764a4",
"name": "0kwxf"
},
{
"id": "78036116-507e-4969-939e-7fc9683a73f9",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}