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

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
I