POST
/
v1
/
communications
/
templates
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": [
        {
          "id": "<string>",
          "communication_stage_id": "<string>",
          "sms_content": "<string>",
          "email_subject": "<string>",
          "email_body": "<string>",
          "slack_content": "<string>"
        }
      ]
    }
  }
}'
{
  "data": {
    "id": "ee03ffb4-ca09-4b1b-a696-c24a6d9748ba",
    "type": "communications-templates",
    "attributes": {
      "name": "Incident Created Template",
      "slug": "incident-created-template",
      "description": "Template for incident creation notifications",
      "position": 11,
      "communication_type_id": "e4e0edcf-e431-4510-a51a-3c6b70ac67e4",
      "created_at": "2025-06-18T16:02:20.536-07:00",
      "updated_at": "2025-06-18T16:02:20.536-07:00",
      "communication_type": {
        "data": {
          "id": "e4e0edcf-e431-4510-a51a-3c6b70ac67e4",
          "type": "communications_types",
          "attributes": {
            "name": "2jnup",
            "slug": "2jnup",
            "description": "Quia impedit maxime deleniti.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2025-06-18T16:02:18.353-07:00",
            "updated_at": "2025-06-18T16:02:18.353-07:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "7ac8b3a1-3289-4e7c-9e60-58f40059b7c6",
                "name": "rsfi9"
              },
              {
                "id": "179f6c3e-d041-401c-a457-0bf49d05aaf8",
                "name": "d9yg5"
              },
              {
                "id": "325215a1-cda2-4547-ac9b-95c55d9d1516",
                "name": "8u08p"
              },
              {
                "id": "0a0088d4-527b-48f7-9626-2314b6f3cb0c",
                "name": "6uj8u"
              },
              {
                "id": "1c7e9a70-9d5c-4bfd-93eb-0bb010e42077",
                "name": "q3ejk"
              },
              {
                "id": "b6f7216e-3a7e-4735-b42f-4a8394f9e5d8",
                "name": "7we9u"
              },
              {
                "id": "effc7478-1772-4995-853a-2ea8702fcf03",
                "name": "12cbk"
              },
              {
                "id": "270faa8a-bc1d-4d20-9251-06c5ef537a34",
                "name": "0ly13"
              },
              {
                "id": "788a9f28-3d44-48b1-b965-5bb93a9bd29b",
                "name": "gkrv0"
              },
              {
                "id": "52c531df-c013-40e4-9ead-6dcb67ade334",
                "name": "9x7wj"
              },
              {
                "id": "ee03ffb4-ca09-4b1b-a696-c24a6d9748ba",
                "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

Response

201
application/vnd.api+json

communications template created

The response is of type object.