1. Labels
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • 🆕 MCP Server
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • Limits by Social Network
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Labels

Create a Label

POST
/labels
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.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.swonkie.dev/v2/labels' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: ' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Campaign Q1 2026"
}'
Response Response Example
{
    "id": "TGFiZWxJZDExMTExMTEx",
    "name": "Product Launch",
    "color": "#777680"
}
Modified at 2026-03-12 12:25:52
Previous
List Labels
Next
Media
Built with