Create a Label

Creates a new label (tag) in your workspace. Labels are used to organize and categorize posts, making it easier to filter and manage your content calendar. Once created, labels can be assigned to posts to help with organization and filtering.

Notes

Label names must be between 1 and 50 characters.

Labels are created with a random color by default. Colors can be assigned through the platform's user interface.

Label names do not need to be unique - you can have multiple labels with the same name if needed.

Once created, use the label ID to tag posts via the labelIds field in POST or PUT /posts endpoints.

Labels are workspace-specific and can only be used within the workspace where they were created.

curl --location --request POST 'https://api.swonkie.dev/v2/labels' \ --header 'X-API-ID: {{apiId}}' \ --header 'X-API-KEY: {{apiKey}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "Campaign Q1 2026" }'

Notes

Request

Responses

Create a Label

Notes#

Request

Responses

Notes