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": "9ca3fe8d-751a-456e-a571-cbc01e4609db",
    "type": "communications_templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "created_at": "2026-01-30T14:59:20.641-08:00",
      "updated_at": "2026-01-30T14:59:20.641-08:00",
      "communication_type_id": "2da345eb-6c7d-4785-b2a5-d344d4b47de8",
      "communication_type": {
        "data": {
          "id": "2da345eb-6c7d-4785-b2a5-d344d4b47de8",
          "type": "communications_types",
          "attributes": {
            "name": "1lu45",
            "slug": "1lu45",
            "description": "Dolorem optio placeat illo.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2026-01-30T14:59:18.971-08:00",
            "updated_at": "2026-01-30T14:59:18.971-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "b0f1a2db-c224-4820-9718-95b57a996b1b",
                "name": "bjn0t"
              },
              {
                "id": "89a85ccc-7fb2-407c-bf87-41aad99c0785",
                "name": "vdd4x"
              },
              {
                "id": "7ee5b03c-5443-4409-8eeb-8299adbeeeb8",
                "name": "wksbr"
              },
              {
                "id": "5484768a-2132-4a56-a92c-edcf870224a2",
                "name": "y0e6d"
              },
              {
                "id": "760b8991-6ea5-4dd0-8987-3d485874e7c4",
                "name": "g0vd8"
              },
              {
                "id": "4d1d554d-5255-447b-8de2-9dc5934cb230",
                "name": "sjjvr"
              },
              {
                "id": "e72fcfb1-613f-467e-b971-1ef49163c768",
                "name": "pglic"
              },
              {
                "id": "611caa52-be15-4a2c-a866-2d821a19f4c0",
                "name": "hwday"
              },
              {
                "id": "90c902ea-dfb5-47de-a4aa-601e72924e91",
                "name": "ignra"
              },
              {
                "id": "2de3c371-f423-4735-9eec-15123b1d460b",
                "name": "411gd"
              },
              {
                "id": "9ca3fe8d-751a-456e-a571-cbc01e4609db",
                "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