Skip to main content
ZStack
Alerting & Response/Alert Templates

CreateAlertTemplate

Create a new message template for alert notifications

POST/api/v1/alerting/templates

Operation ID

CreateAlertTemplate

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • name
    StringRequired

    Human-readable template name

    Example: Custom Email Template

  • format
    StringRequired

    Template format: markdown, html, json, or plain_text

    Example: markdown

  • content
    StringRequired

    Template content with variable placeholders

    Example: # Alert: {{.AlertName}}

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the template

    Example: tmpl-001

  • name
    String

    Human-readable template name

    Example: Default Email Template

  • format
    String

    Template format: markdown, html, json, or plain_text

    Example: markdown

  • content
    String

    Template content with variable placeholders

    Example: # Alert: {{.AlertName}}

  • source
    String

    Template source: builtin or custom

    Example: builtin

  • createDate
    String

    Timestamp when the template was created

    Example: 2026-01-15T08:00:00Z

  • lastOpDate
    String

    Timestamp of the last template modification

    Example: 2026-01-15T08:00:00Z