POST
/
v1
/
communications
/
templates
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": "da63cfeb-44c3-4a23-ad1f-05285b308d75",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-07-09T01:14:11.113-07:00",
      "updated_at": "2025-07-09T01:14:11.113-07:00",
      "communication_type_id": "36d54484-4b24-46b2-8f9c-c1b07b958c40",
      "communication_type": {
        "data": {
          "id": "36d54484-4b24-46b2-8f9c-c1b07b958c40",
          "type": "communications_types",
          "attributes": {
            "name": "lmvra",
            "slug": "lmvra",
            "description": "Nihil accusantium ut nam.",
            "color": "#F5D9C4",
            "position": 1,
            "created_at": "2025-07-09T01:14:08.533-07:00",
            "updated_at": "2025-07-09T01:14:08.533-07:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "1edea224-14c7-42b9-bbbb-1c35bf632f35",
                "name": "v6c4h"
              },
              {
                "id": "4b9b465c-bfef-4f98-b91d-67f8b70e0ed2",
                "name": "30qll"
              },
              {
                "id": "e4468983-7096-46ed-8734-58a2189fc841",
                "name": "ra2aj"
              },
              {
                "id": "39f42e20-56c6-445a-af5e-2335ec412bdf",
                "name": "qtuqj"
              },
              {
                "id": "35d4ee75-9093-43d0-b58e-02f6feb66041",
                "name": "dv8y4"
              },
              {
                "id": "06546ce7-ddbd-464e-aae3-2887a084700f",
                "name": "7i9hn"
              },
              {
                "id": "70f0b397-cff9-49b6-8a33-dfa7600bc60a",
                "name": "066gw"
              },
              {
                "id": "6dae5d25-6170-486a-a917-2728c5ad138c",
                "name": "osrfm"
              },
              {
                "id": "ca1e2a8e-fdff-4b11-8a8f-8ccd52fd7d41",
                "name": "l3mb9"
              },
              {
                "id": "e7162b8f-ffab-49aa-8c15-a0fa2f6603b6",
                "name": "b06ia"
              },
              {
                "id": "da63cfeb-44c3-4a23-ad1f-05285b308d75",
                "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.