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": "c4403122-5a06-4126-b7f6-0cdbdae23d81",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2025-12-21T12:07:11.854-08:00",
      "updated_at": "2025-12-21T12:07:11.854-08:00",
      "communication_type_id": "badcb1d1-10a2-4744-900d-ad9706200c07",
      "communication_type": {
        "data": {
          "id": "badcb1d1-10a2-4744-900d-ad9706200c07",
          "type": "communications_types",
          "attributes": {
            "name": "eos4v",
            "slug": "eos4v",
            "description": "Autem ex tempore eaque.",
            "color": "#FAEBB7",
            "position": 1,
            "created_at": "2025-12-21T12:07:10.729-08:00",
            "updated_at": "2025-12-21T12:07:10.729-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "36ed1e3a-b956-4066-95de-378be57fc44f",
                "name": "czcvw"
              },
              {
                "id": "673b5b1e-a752-4238-bdd3-a1b3a0373849",
                "name": "xudma"
              },
              {
                "id": "e259116d-3e1e-4c7c-97c4-9de35c861864",
                "name": "qoaay"
              },
              {
                "id": "8303823a-cde0-4e0b-9b43-0e6286407a5f",
                "name": "rwwo6"
              },
              {
                "id": "d9e1defc-329b-4fef-8e69-3bff55e99a98",
                "name": "1v4q3"
              },
              {
                "id": "25c62dc0-8f47-4093-bd76-5e4c5de4095b",
                "name": "lf13g"
              },
              {
                "id": "bf5c1edf-d7dd-48a4-820d-323d0b664026",
                "name": "twt94"
              },
              {
                "id": "a4f700ba-25c2-4fb0-a870-b9e7fe81d1f6",
                "name": "ha3qx"
              },
              {
                "id": "a7790e66-1a17-4418-85bc-cae4052780fe",
                "name": "b0ipw"
              },
              {
                "id": "058fb27a-2c53-4131-87ae-a980ddbc03be",
                "name": "dy0vf"
              },
              {
                "id": "c4403122-5a06-4126-b7f6-0cdbdae23d81",
                "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