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": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-09-08T13:44:07.667-07:00",
      "updated_at": "2025-09-08T13:44:07.667-07:00",
      "communication_type_id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
      "communication_type": {
        "data": {
          "id": "f433475f-14d9-4db2-bc7a-a3011eb24472",
          "type": "communications_types",
          "attributes": {
            "name": "uzzrc",
            "slug": "uzzrc",
            "description": "Eveniet fuga expedita velit.",
            "color": "#D7E7F5",
            "position": 1,
            "created_at": "2025-09-08T13:44:05.757-07:00",
            "updated_at": "2025-09-08T13:44:05.757-07:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "47e63ac5-debf-4c80-ac1a-fdbbb2cd0e77",
                "name": "v5ykr"
              },
              {
                "id": "c34d6371-b6f4-472b-bfe9-9f18c4449ad6",
                "name": "t4kl8"
              },
              {
                "id": "91a6bd76-94f4-4df9-b1dc-e28eb289094f",
                "name": "i3af0"
              },
              {
                "id": "91dca44a-e53b-489b-9a43-dc1fa84c4152",
                "name": "kk5yj"
              },
              {
                "id": "29f909c1-b3d8-4a92-a620-e73ad8389d49",
                "name": "6ti7b"
              },
              {
                "id": "df202f71-e980-483a-a774-52a65616547a",
                "name": "pnwki"
              },
              {
                "id": "dc7adc38-488c-4c53-8cb0-244c7e04d4f7",
                "name": "xi142"
              },
              {
                "id": "0fb51f90-852b-460c-b6b9-8fc96f792732",
                "name": "mpxoj"
              },
              {
                "id": "4055724f-ed72-40da-83f8-4aa6825ddf93",
                "name": "3r6m0"
              },
              {
                "id": "2918e189-e869-4a67-9215-16f1d9ba12fb",
                "name": "96279"
              },
              {
                "id": "c6778fdf-a83a-4dcd-a1f8-5e066f921b38",
                "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

Response

201
application/vnd.api+json

communications template created

The response is of type object.