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>",
      "communication_type_id": "<string>",
      "description": "<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": "0c94fb4e-36ff-4c2c-afe4-2d2426e54cbd",
    "type": "communications_templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2026-02-19T19:09:04.850-08:00",
      "updated_at": "2026-02-19T19:09:04.850-08:00",
      "communication_type_id": "14f9804c-60a0-4768-aec2-593ba0dde5a5",
      "communication_type": {
        "data": {
          "id": "14f9804c-60a0-4768-aec2-593ba0dde5a5",
          "type": "communications_types",
          "attributes": {
            "name": "h7hes",
            "slug": "h7hes",
            "description": "Aliquid adipisci corporis eos.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2026-02-19T19:09:03.441-08:00",
            "updated_at": "2026-02-19T19:09:03.441-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "9bc938a8-9328-4aff-ba9f-495b1abb5e76",
                "name": "a9ha6"
              },
              {
                "id": "03dee3f3-0072-4347-9edb-8dd97537aef2",
                "name": "yh08c"
              },
              {
                "id": "9f94a9a2-9a9b-47cc-a9bf-03cf9dc72d11",
                "name": "cim6v"
              },
              {
                "id": "53d0c74c-af66-4c74-9e18-571576ed4f24",
                "name": "ncif5"
              },
              {
                "id": "a40db279-11f2-4dbd-a05a-711441c96f2c",
                "name": "a92wk"
              },
              {
                "id": "453ffb69-f8f9-4c80-b22b-5e7e83df97fc",
                "name": "3o5bc"
              },
              {
                "id": "b0c7a194-208a-4845-9152-738c43861e51",
                "name": "y7jdy"
              },
              {
                "id": "c4105779-3152-4fec-b0f9-0a07569e3434",
                "name": "jfudh"
              },
              {
                "id": "da30ca45-e1f4-4386-8b44-f28e173a5e0a",
                "name": "5dcgv"
              },
              {
                "id": "479d403d-9112-4a87-a1df-e07ff2f2ea97",
                "name": "bh0oq"
              },
              {
                "id": "0c94fb4e-36ff-4c2c-afe4-2d2426e54cbd",
                "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