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": "b2660982-c102-4521-a8c2-ab1018a5f730",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-12-01T07:37:48.095-08:00",
      "updated_at": "2025-12-01T07:37:48.095-08:00",
      "communication_type_id": "aaf8be31-cbb0-4150-8690-7ba3b53d10b7",
      "communication_type": {
        "data": {
          "id": "aaf8be31-cbb0-4150-8690-7ba3b53d10b7",
          "type": "communications_types",
          "attributes": {
            "name": "ofcih",
            "slug": "ofcih",
            "description": "Consequatur enim autem nemo.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2025-12-01T07:37:46.277-08:00",
            "updated_at": "2025-12-01T07:37:46.277-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "4ef9c2f9-f5b0-4379-aab9-c33f0730f17c",
                "name": "5as90"
              },
              {
                "id": "26bcd0a9-b5cc-440d-a8aa-057f9626a67d",
                "name": "qtuwy"
              },
              {
                "id": "2b60507f-0acf-493d-87e4-61dcaee211d9",
                "name": "a0w92"
              },
              {
                "id": "8d51a72f-773c-44e0-a2fd-129e864fe2f1",
                "name": "jidfs"
              },
              {
                "id": "aa2f3339-ca73-4fd7-b15c-fc23102ae0c7",
                "name": "rhfu8"
              },
              {
                "id": "06c40a71-d853-4e05-96b2-119998a559c1",
                "name": "ptwjf"
              },
              {
                "id": "aaffeeaf-d402-4f49-8642-37686fb3de99",
                "name": "7t2th"
              },
              {
                "id": "d38ad0c2-838b-4377-8b92-1215bbcfd8db",
                "name": "tdaa3"
              },
              {
                "id": "82e6a80d-2c10-4d21-a290-48dfa8e6d16c",
                "name": "ylymj"
              },
              {
                "id": "684b2018-db29-42f4-9b20-b4cdd91e4baa",
                "name": "5r0gm"
              },
              {
                "id": "b2660982-c102-4521-a8c2-ab1018a5f730",
                "name": "Incident Created Template"
              }
            ]
          }
        }
      },
      "communication_template_stages": []
    }
  }
}

Authorizations

Authorization
string
header
required

Body

application/vnd.api+json
data
object
required

Response

data
object
required