Skip to navigation
Social MediaTags

Social · Tags · List social-media tags (labels)

View as Markdown

Returns all tags (a.k.a. “labels”) available for filtering and assigning to social-media posts/drafts. Tags are workspace-wide and shared by all users in the workspace. Always pass product=social_media so PM tags are not returned. Pagination is disabled.

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.

Query parameters

productenumRequiredDefaults to social_media

Always social_media for this MCP — filters out PM tags.

Allowed values:
paginationenumOptionalDefaults to false

Always "false" — returns the full list without paging.

Allowed values:

Response

Paginated list of tags (DRF envelope; tags in results).

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: