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": "08ee7f21-c332-49cf-87ad-14040dece535",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-12-19T18:14:22.656-08:00",
      "updated_at": "2025-12-19T18:14:22.656-08:00",
      "communication_type_id": "811681e1-3fcd-4d5a-ba92-90faea51a127",
      "communication_type": {
        "data": {
          "id": "811681e1-3fcd-4d5a-ba92-90faea51a127",
          "type": "communications_types",
          "attributes": {
            "name": "40unw",
            "slug": "40unw",
            "description": "Accusantium totam quia velit.",
            "color": "#F5D9C4",
            "position": 1,
            "created_at": "2025-12-19T18:14:21.506-08:00",
            "updated_at": "2025-12-19T18:14:21.506-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "93a18699-48bb-40d4-a0a3-6921ac8bbde1",
                "name": "nonex"
              },
              {
                "id": "c632627c-f159-4bea-be8d-8c36ddc4eaaa",
                "name": "wpu38"
              },
              {
                "id": "30495c58-85c5-4997-80ad-49362480e414",
                "name": "k7rkb"
              },
              {
                "id": "dda6666f-53b6-489b-88ca-19b9125f824b",
                "name": "lm68f"
              },
              {
                "id": "724f0786-abc1-4894-96ee-8f20d649e80e",
                "name": "f87x4"
              },
              {
                "id": "a1e14767-65ff-4fe4-890c-5b601bdf05da",
                "name": "64321"
              },
              {
                "id": "137f0d89-6c04-4e73-9cd8-d2c289f7d23f",
                "name": "yspfv"
              },
              {
                "id": "80a736b8-b46d-4a27-bbf5-0f9176f52389",
                "name": "0ny4w"
              },
              {
                "id": "7a0efc9a-3910-4538-865c-4de9528a1750",
                "name": "tlce3"
              },
              {
                "id": "f6a074c1-6fc4-4bb5-86ac-cc4f82fca115",
                "name": "gfa68"
              },
              {
                "id": "08ee7f21-c332-49cf-87ad-14040dece535",
                "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