---
title: "Create Item"
method: POST
path: "/api/v2/dynamic_content/items"
tags: ["Dynamic Content"]
---

# Create Item

`POST /api/v2/dynamic_content/items`

Create a new content item, with one or more variants in the item's `variants` array. See [Specifying item variants](#specifying-item-variants).

The `default_locale_id` and variant `locale_id` values must be one of the locales the account has active. You can get the list with the [List Locales](/api-reference/ticketing/account-configuration/locales/#list-locales) endpoint.

#### Allowed For

* Admins, Agents

## Response `201`

Created response

- DynamicContentResponse
  - `item` DynamicContentObject
    - `created_at` string, date-time — When this record was created
    - `default_locale_id` integer, required — The default locale for the item. Must be one of the [locales the account has active](/api-reference/ticketing/account-configuration/locales/#list-locales).
    - `id` integer — Automatically assigned when creating items
    - `name` string, required — The unique name of the item
    - `outdated` boolean — Indicates the item has outdated variants within it
    - `placeholder` string — Automatically generated placeholder for the item, derived from name
    - `updated_at` string, date-time — When this record was last updated
    - `url` string — The API url of this item
    - `variants` DynamicContentVariantObject[], required — All variants within this item. See [Dynamic Content Item Variants](/api-reference/ticketing/ticket-management/dynamic_content_item_variants/)
      - `active` boolean — If the variant is active and useable
      - `content` string, required — The content of the variant
      - `created_at` string, date-time — When the variant was created
      - `default` boolean — If the variant is the default for the item it belongs to
      - `id` integer — Automatically assigned when the variant is created
      - `locale_id` integer, required — An active locale
      - `outdated` boolean — If the variant is outdated
      - `updated_at` string, date-time — When the variant was last updated
      - `url` string — The API url of the variant

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)