Skip to main content
POST
/
v1
/
communications
/
templates
Creates a communications template
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": "b7ff585f-4e18-46bb-9d97-33adbf97621f",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-11-27T00:06:51.543-08:00",
      "updated_at": "2025-11-27T00:06:51.543-08:00",
      "communication_type_id": "613e5834-8cf3-431e-a1fd-e95f8cd60036",
      "communication_type": {
        "data": {
          "id": "613e5834-8cf3-431e-a1fd-e95f8cd60036",
          "type": "communications_types",
          "attributes": {
            "name": "wd4y7",
            "slug": "wd4y7",
            "description": "Incidunt sunt ea quo.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2025-11-27T00:06:49.553-08:00",
            "updated_at": "2025-11-27T00:06:49.553-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "1e233eb9-5d0b-40e8-9e35-72642a9ccc65",
                "name": "uwbgr"
              },
              {
                "id": "523cfc7b-bcd6-435a-bafb-450c3e6a9dc8",
                "name": "aov1u"
              },
              {
                "id": "81bf935d-5f5b-4381-abac-bab613d8c4a9",
                "name": "ki76q"
              },
              {
                "id": "77e556cc-4cdc-415c-a2bb-28c6f47b2367",
                "name": "9lw41"
              },
              {
                "id": "00461271-29b9-4528-8588-e0d3dd73216f",
                "name": "tuwdg"
              },
              {
                "id": "20ad918b-76a0-4bcb-8b0c-779e86a915ac",
                "name": "d0nkg"
              },
              {
                "id": "008c542f-0952-4807-a619-ef9061d346ef",
                "name": "udyvj"
              },
              {
                "id": "266b41ad-564f-4699-91e3-93a84916be0b",
                "name": "ngp7z"
              },
              {
                "id": "72440d82-d4ed-4c7c-a0e1-e070b1f29488",
                "name": "hoqjg"
              },
              {
                "id": "7d746dbc-5f43-4318-b5a7-b18c35d07470",
                "name": "zv1uz"
              },
              {
                "id": "b7ff585f-4e18-46bb-9d97-33adbf97621f",
                "name": "Incident Created Template"
              }
            ]
          }
        }
      },
      "communication_template_stages": []
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/vnd.api+json
​
data
object
required

Response

communications template created

​
data
object
required