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": "ffb88130-1dd6-4c1c-ba2f-cfd65df6d539",
    "type": "communications_templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2026-01-10T13:34:37.821-08:00",
      "updated_at": "2026-01-10T13:34:37.821-08:00",
      "communication_type_id": "12288b86-4e28-495c-ad89-ecec179cfec0",
      "communication_type": {
        "data": {
          "id": "12288b86-4e28-495c-ad89-ecec179cfec0",
          "type": "communications_types",
          "attributes": {
            "name": "gcmje",
            "slug": "gcmje",
            "description": "Qui iusto quisquam sunt.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2026-01-10T13:34:36.524-08:00",
            "updated_at": "2026-01-10T13:34:36.524-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "cc403bb9-f6b4-4260-b828-526f9de74416",
                "name": "talrf"
              },
              {
                "id": "6e24023d-7010-494f-ac66-6468d942eed2",
                "name": "ls29f"
              },
              {
                "id": "4daaff34-7190-4cea-84df-a474e8f1c9c3",
                "name": "m1q7q"
              },
              {
                "id": "9c040e87-6798-4a89-913c-3e5e79570503",
                "name": "apybj"
              },
              {
                "id": "523c8380-ced5-41e1-8034-38f7bd394ef7",
                "name": "ua2jq"
              },
              {
                "id": "89b26837-dc4c-40c4-a361-2b76cf3cead1",
                "name": "s0dcu"
              },
              {
                "id": "44b2c87d-8a4c-407f-a7e3-eb2ad8665b44",
                "name": "6zwol"
              },
              {
                "id": "29d0640d-55a6-48d5-9a3a-fb3e251a7c73",
                "name": "u5d73"
              },
              {
                "id": "759218b6-3bb8-4eb6-bce3-a221127325c5",
                "name": "hx16i"
              },
              {
                "id": "2530f561-e1ec-4fb2-a41a-679fa400fd17",
                "name": "m5xe4"
              },
              {
                "id": "ffb88130-1dd6-4c1c-ba2f-cfd65df6d539",
                "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