Skip to navigation
Social MediaTags

Social · Tags · Create a new social-media tag (label)

View as Markdown

Creates a new tag for social-media posts. Tag names are NOT enforced unique by the backend — call listSocialMediaTags first and reuse an existing tag if a tag with the same name already exists, to avoid creating duplicates.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired

Display name for the new tag. Should be human-readable.

productenumRequiredDefaults to social_media

Always social_media for this MCP.

Allowed values:
colorstringOptional

Optional hex color for the UI badge (e.g. "#3F51B5"). Backend assigns a default if omitted.

Response

Tag created
idinteger

Numeric tag ID. Use this when assigning tags to posts/drafts.

namestring

Display name of the tag (e.g. "Q2 launch").

colorstringOptional

Hex color used in the UI badge (e.g. "#FF5722"). May be empty.

productenumOptional

Product the tag belongs to. Always social_media for this MCP.

Allowed values: