---
title: "Create a monitor user template"
method: POST
path: "/api/v2/monitor/template"
tags: ["Monitors"]
---

# Create a monitor user template

`POST /api/v2/monitor/template`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/monitor/template`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create a new monitor user template.

## Request body

- MonitorUserTemplateCreateRequest: Request for creating a monitor user template.
  - `data` MonitorUserTemplateCreateData, required: Monitor user template data.
    - `attributes` MonitorUserTemplateRequestAttributes, required: Attributes for a monitor user template.
      - `description` string, nullable: A brief description of the monitor user template.
      - `monitor_definition` object, required: A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
      - `tags` string[], required: The definition of `MonitorUserTemplateTags` object.
      - `template_variables` MonitorUserTemplateTemplateVariablesItems[]: The definition of `MonitorUserTemplateTemplateVariables` object.
        - `available_values` string[]: Available values for the variable.
        - `defaults` string[]: Default values of the template variable.
        - `name` string, required: The name of the template variable.
        - `tag_key` string: The tag key associated with the variable. This works the same as dashboard template variables.
      - `title` string, required: The title of the monitor user template.
    - `type` 'monitor-user-template', required: Monitor user template resource type.

## Response `200`

OK

- MonitorUserTemplateCreateResponse: Response for creating a monitor user template.
  - `data` MonitorUserTemplateResponseData: Monitor user template list response data.
    - `attributes` MonitorUserTemplateResponseAttributes: Attributes for a monitor user template.
      - `created` string, date-time: The created timestamp of the template.
      - `description` string, nullable: A brief description of the monitor user template.
      - `modified` string, date-time: The last modified timestamp. When the template version was created.
      - `monitor_definition` object: A valid monitor definition in the same format as the [V1 Monitor API](https://docs.datadoghq.com/api/latest/monitors/#create-a-monitor).
      - `tags` string[]: The definition of `MonitorUserTemplateTags` object.
      - `template_variables` MonitorUserTemplateTemplateVariablesItems[]: The definition of `MonitorUserTemplateTemplateVariables` object.
        - `available_values` string[]: Available values for the variable.
        - `defaults` string[]: Default values of the template variable.
        - `name` string, required: The name of the template variable.
        - `tag_key` string: The tag key associated with the variable. This works the same as dashboard template variables.
      - `title` string: The title of the monitor user template.
      - `version` integer, nullable: The version of the monitor user template.
    - `id` string: The unique identifier.
    - `type` 'monitor-user-template': Monitor user template resource type.

## Other responses

- `400`: Bad Request
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)