---
title: "Create a hashtag set"
method: POST
path: "/hashtag-sets"
tags: ["Hashtag Sets"]
---

# Create a hashtag set

`POST /hashtag-sets`

Saves a reusable, named group of hashtags. Tags may be passed with or without the leading '#'; they are deduped case-insensitively and stored in order. Max 100 tags per set.

## Request body

- object
  - `name` string, required — Set name, e.g. "Fitness Brand". Unique per workspace.
  - `hashtags` union, required — Array of tags (["fitness", "#gym"]) or a single string ("#fitness
    - string[]
    - string

## Response `201`

Hashtag set created

- object
  - `data` HashtagSet
    - `id` string
    - `name` string — Set name, unique per workspace (case-insensitive)
    - `hashtags` string[] — Ordered tags WITHOUT the leading '#'
    - `hashtag_count` integer
    - `preview` string — The tags rendered as caption text, e.g. "#fitness
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400` — Invalid name/hashtags or duplicate name

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)