Queues and evergreen content
Categories for your content and queues that re-post evergreen posts into your free time slots automatically.
Content categories
Categories are labels (a name and a colour) per workspace, for example Tips, Promotions or Behind the scenes. Assign one in the composer under Campaign, category & tags. Filter the Calendar and the Posts list by category. Deleting a category only removes the label from posts.
How a queue works
A queue holds evergreen items (new text and media, or copies of existing posts), posts to the accounts you choose and uses either the accounts' posting times or its own custom times. The worker keeps the number of posts you ask for (1 to 5) scheduled ahead. Each pass takes the next free time slot and the next eligible item, and creates a normal post, so roles, approval flows, plan limits and platform checks all apply.
- Rotation: the least recently posted item goes first; new items before posted ones. Turn on Shuffle for a random pick.
- Cooldown days: an item is not repeated until that many days after it was last scheduled.
- Max repeats: stop using an item after it was scheduled that many times (blank = no limit).
- Pause and resume a queue at any time. Items can be switched off individually.
- Fill now runs a pass immediately instead of waiting for the worker.
API
| Endpoint | Purpose |
|---|---|
GET/POST /api/categories, PATCH/DELETE /api/categories/:id | Manage categories. |
GET/POST /api/queues, GET/PATCH/DELETE /api/queues/:id | Queues and their settings (status active or paused). |
POST /api/queues/:id/items, PATCH/DELETE /api/queues/:id/items/:itemId | Add (body and media_ids, or post_ids), switch off or remove items. |
POST /api/queues/:id/run | Run one scheduling pass now. |
category_id is accepted when creating or updating a post, and GET /api/posts and GET /api/calendar accept ?category_id=.