---
title: "Create a merge tag"
method: POST
path: "/merge-tags"
tags: ["MergeTags"]
---

# Create a merge tag

`POST /merge-tags`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/merge-tags`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/merge-tags/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a [merge tag](#tag/merge_tag). Requires permission to manage merge tags.

## Request body

- object
  - `name` string, required
  - `platform_id` string, required
  - `merge_tag_value` string, required
  - `description` string
  - `is_special_link` boolean
  - `velocity_script_token` string

## Response `200`

OK

- MergeTag
  - `type` string
  - `id` string
  - `attributes` MergeTagAttributes
    - `id` string
    - `name` string
    - `description` string
    - `is_special_link` boolean
    - `platform_id` string
    - `merge_tag_value` string
    - `velocity_script_token` string, nullable
    - `knak_tag` string: A paste-ready merge-tag token you can embed directly in asset content. Knak resolves it to the correct platform merge tag when the asset is synced. See the [Merge Tag Model](#tag/merge_tag) for the content syntax.

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Unauthorized

---

[API](https://skmtc.dev/knak/apis/knak-enterprise-api.md) - [All operations](https://skmtc.dev/knak/apis/knak-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knak/apis/knak-enterprise-api/revisions/31d2c94edfcc?raw)