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": "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": []
    }
  }
}

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