Create template

Creates a notification template.

post

Creates a new notification template in draft state. Add language variants and activate before use.

Body

application/jsontext/jsonapplication/*+json

namestringOptional

descriptionstring · nullableOptional

externalIdstring · nullableOptional

Responses

201

Created

application/json

Represents a reusable template that can be used to generate messages.

idstringOptional

namestringOptional

revisioninteger · int32Optional

descriptionstring · nullableOptional

Gets or sets the description of this template.

lastUsedstring · date-time · nullableOptional

Gets or sets the timestamp of when this template was last used to send a notification.

statusstringOptional

Gets or sets the current status of the template.

externalIdstring · nullableOptional

Gets or sets an external identifier for integration with external systems.

400

Bad Request

application/json

404

Not Found

application/json

post/public/v1/notifications/templates

HTTPcURLJavaScriptPython

POST /public/v1/notifications/templates HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 232

{
  "name": "text",
  "description": "text",
  "category": {
    "id": "text"
  },
  "criteria": {
    "accountTypes": [
      "Client"
    ],
    "objectType": "Account",
    "filterCondition": "text",
    "recipients": {
      "selector": "text"
    }
  },
  "externalId": "text",
  "defaultVariant": {
    "id": "text"
  }
}

application/jsontext/jsonapplication/*+json

{
  "id": "text",
  "audit": {
    "created": {
      "at": "2026-08-07T20:38:39.994Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "updated": {
      "at": "2026-08-07T20:38:39.994Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "activated": {
      "at": "2026-08-07T20:38:39.994Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "deleted": {
      "at": "2026-08-07T20:38:39.994Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "disabled": {
      "at": "2026-08-07T20:38:39.994Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "name": "text",
  "revision": 1,
  "category": {
    "id": "text",
    "name": "text",
    "revision": 1,
    "description": "text",
    "lastUsed": "2026-08-07T20:38:39.994Z"
  },
  "criteria": {
    "accountTypes": [
      "text"
    ],
    "filterCondition": "text",
    "objectType": "text",
    "recipients": {
      "selector": "text"
    }
  },
  "defaultVariant": {
    "id": "text",
    "revision": 1,
    "default": true,
    "languageCode": "text",
    "status": "text"
  },
  "description": "text",
  "lastUsed": "2026-08-07T20:38:39.994Z",
  "owner": {
    "id": "text",
    "name": "text",
    "icon": "text",
    "revision": 1,
    "type": "Client",
    "status": "Active"
  },
  "statistics": {
    "month": 1,
    "today": 1,
    "week": 1
  },
  "status": "text",
  "variants": [
    {
      "id": "text",
      "revision": 1,
      "default": true,
      "languageCode": "text",
      "status": "text"
    }
  ],
  "externalId": "text"
}