---
title: "Add a new tag to the store"
method: POST
path: "/tag/create"
tags: ["Tags"]
---

# Add a new tag to the store

`POST /tag/create`

## Request

- Base URL: `https://asm.cloud.tenable.com/api/1.0`
- URL: `https://asm.cloud.tenable.com/api/1.0/tag/create`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/tenable/apis/attack-surface-management/docs/tag/create/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string, required
  - `value_type` 'keyword' | 'number' | 'date' | 'percentage' | 'cost' | 'boolean' | 'fulltext': Omit this field to create a normal Tag. If set, the created Tag will appear as a Custom Column on the UI.

## Response `200`

OK

- object
  - `id` integer
  - `order` integer
  - `name` string
  - `value_type` string

## Other responses

- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/tenable/apis/attack-surface-management.md) - [All operations](https://skmtc.dev/tenable/apis/attack-surface-management/llms.txt) - [OpenAPI document](https://skmtc.dev/tenable/apis/attack-surface-management/revisions/465c06285e48?raw)