Create Tag

POST/api/v1/dashboard/content/tags

Overview

Creates a new tag for the authenticated client. Tags are flat labels used to organize posts across categories. A URL slug is auto-generated from the name if not provided.

Authentication

info

Bearer authentication required - Pass your credentials as Authorization: Bearer <client_id>:<api_key>:<api_secret>.

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer <client_id>:<api_key>:<api_secret>
Content-Type	string	Yes	application/json

Request Body

Parameter	Type	Required	Description
name	string	Yes	Tag display name
slug	string	No	URL-friendly slug (auto-generated from name if omitted)
description	string	No	Optional tag description

Response

idstring (UUID)

Unique tag identifier

namestring

Tag display name

slugstring

URL-friendly slug

descriptionstring | null

Tag description

Example Request

cURL

curl -X POST "https://spideriq.ai/api/v1/dashboard/content/tags" \
  -H "Authorization: Bearer $CLIENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Lead Generation",
    "description": "Tips and strategies for generating leads at scale"
  }'

Python

import requests

resp = requests.post(
    "https://spideriq.ai/api/v1/dashboard/content/tags",
    headers={"Authorization": f"Bearer {CLIENT_TOKEN}"},
    json={
        "name": "Lead Generation",
        "description": "Tips and strategies for generating leads at scale",
    },
)
tag = resp.json()

print(f"Created tag: {tag['id']}")
print(f"Slug: {tag['slug']}")

JavaScript

const resp = await fetch(
  "https://spideriq.ai/api/v1/dashboard/content/tags",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${CLIENT_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      name: "Lead Generation",
      description: "Tips and strategies for generating leads at scale",
    }),
  }
);
const tag = await resp.json();

console.log(`Created tag: ${tag.id}`);
console.log(`Slug: ${tag.slug}`);

Example Response

{
  "id": "tag-004-uuid",
  "name": "Lead Generation",
  "slug": "lead-generation",
  "description": "Tips and strategies for generating leads at scale"
}

Status Codes

Status Code	Meaning	Description
201	Created	Tag created successfully
400	Bad Request	Missing required fields
401	Unauthorized	Invalid or missing Bearer token
409	Conflict	A tag with this slug already exists

Related Endpoints

pen

Update Tag

Update a tag

trash

Delete Tag

Delete a tag

tags

List Tags

List all tags with post counts

➕

Create Post

Create a post with tags