tags/post

Tool: create

Create a new tag.

Creates a tag and returns it with its assigned tagId. Use tagId (not the name) when attaching the tag to prospects, campaigns, or senders. tagType defaults to Crm and is immutable after creation.

Duplicate title within the same tagType returns 409. The same title is allowed across different tag types.

Body

field	type	req	constraints	description
title	string	✓	≤128 chars	Tag name.
tagType	string	–	one of: Campaign, Crm, Sender	Defaults to `Crm`. Immutable after creation.
description	string	–	≤1000 chars	Optional description.

Response

201 — created tag: {tagId, title, description, tagType, createdAt}. Deltas: none.

Errors: 400, 401, 406, 409, 415, 422, 429, 500 — shared schema: schemas/errors. 409 = duplicate title within the same type.

Invoke

Call create with name: "tags/post".