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": "5a4a8c56-560e-4db9-a4ab-7292f8e97a12",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-09-26T17:24:25.150-07:00",
"updated_at": "2025-09-26T17:24:25.150-07:00",
"communication_type_id": "5869ed9d-7b09-4e90-8841-2d1ae4e47424",
"communication_type": {
"data": {
"id": "5869ed9d-7b09-4e90-8841-2d1ae4e47424",
"type": "communications_types",
"attributes": {
"name": "hwxog",
"slug": "hwxog",
"description": "Sed pariatur ut nam.",
"color": "#F5D9C4",
"position": 1,
"created_at": "2025-09-26T17:24:23.420-07:00",
"updated_at": "2025-09-26T17:24:23.420-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "b37279d2-b929-4d14-be4f-6296d7e39076",
"name": "q2tkm"
},
{
"id": "dae09692-d918-46cb-815f-afbef03d5e6b",
"name": "jsdbo"
},
{
"id": "cc6f1a4d-26a5-492d-a353-6140830e074f",
"name": "19zvk"
},
{
"id": "b1f12b81-fd2f-4fe0-8a55-792b0fbeb83e",
"name": "nyc5s"
},
{
"id": "fb125f22-0129-4f27-9772-4c13bf3ea764",
"name": "5b9sd"
},
{
"id": "87250b4a-30cf-44d2-8de1-f0dacc5152f8",
"name": "7doj0"
},
{
"id": "00ec5b23-8ab3-425a-b459-a3f06755fba6",
"name": "5qr2p"
},
{
"id": "38aebe4f-e340-4756-9aa3-40deca2a0fe2",
"name": "0lq2o"
},
{
"id": "776d28bf-c867-4f57-ae57-9c84495e2000",
"name": "4120b"
},
{
"id": "fce71a26-50eb-4981-9e0f-a937c9313948",
"name": "s0tt6"
},
{
"id": "5a4a8c56-560e-4db9-a4ab-7292f8e97a12",
"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": "5a4a8c56-560e-4db9-a4ab-7292f8e97a12",
"type": "communications-templates",
"attributes": {
"name": "Incident Created Template",
"slug": "incident-created-template",
"description": "Template for incident creation notifications",
"position": 11,
"created_at": "2025-09-26T17:24:25.150-07:00",
"updated_at": "2025-09-26T17:24:25.150-07:00",
"communication_type_id": "5869ed9d-7b09-4e90-8841-2d1ae4e47424",
"communication_type": {
"data": {
"id": "5869ed9d-7b09-4e90-8841-2d1ae4e47424",
"type": "communications_types",
"attributes": {
"name": "hwxog",
"slug": "hwxog",
"description": "Sed pariatur ut nam.",
"color": "#F5D9C4",
"position": 1,
"created_at": "2025-09-26T17:24:23.420-07:00",
"updated_at": "2025-09-26T17:24:23.420-07:00",
"communication_groups": [],
"communication_templates": [
{
"id": "b37279d2-b929-4d14-be4f-6296d7e39076",
"name": "q2tkm"
},
{
"id": "dae09692-d918-46cb-815f-afbef03d5e6b",
"name": "jsdbo"
},
{
"id": "cc6f1a4d-26a5-492d-a353-6140830e074f",
"name": "19zvk"
},
{
"id": "b1f12b81-fd2f-4fe0-8a55-792b0fbeb83e",
"name": "nyc5s"
},
{
"id": "fb125f22-0129-4f27-9772-4c13bf3ea764",
"name": "5b9sd"
},
{
"id": "87250b4a-30cf-44d2-8de1-f0dacc5152f8",
"name": "7doj0"
},
{
"id": "00ec5b23-8ab3-425a-b459-a3f06755fba6",
"name": "5qr2p"
},
{
"id": "38aebe4f-e340-4756-9aa3-40deca2a0fe2",
"name": "0lq2o"
},
{
"id": "776d28bf-c867-4f57-ae57-9c84495e2000",
"name": "4120b"
},
{
"id": "fce71a26-50eb-4981-9e0f-a937c9313948",
"name": "s0tt6"
},
{
"id": "5a4a8c56-560e-4db9-a4ab-7292f8e97a12",
"name": "Incident Created Template"
}
]
}
}
},
"communication_template_stages": []
}
}
}