API resource

Posting queue

Recurring weekly time slots for the workspace. Create a post with queuedFromProfile: true (advanced form) and it takes the next open slot.

List schedules

GET/v1/queue/slots

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Returns queue schedules for a profile. Use all=true for all queues, or queueId for a specific one. Defaults to the default queue.

Query parameters

queueIdstring

Specific queue ID to retrieve (optional)

allstring

Set to 'true' to list all queues for the profile

curl "https://creatoros-production-5658.up.railway.app/v1/queue/slots" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "success": true
}

Create schedule

POST/v1/queue/slots

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Create an additional queue for a profile. The first queue created becomes the default. Subsequent queues are non-default unless explicitly set.

Body

namestringrequired

Queue name (e.g., Evening Posts)

timezonestringrequired

IANA timezone

slotsarrayrequired

No description

activeboolean

No description

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/queue/slots" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<name>",
    "timezone": "<timezone>",
    "slots": "<slots>"
  }'

Response 200

{
  "success": true,
  "schedule": "string",
  "nextSlots": [
    "string"
  ]
}

Update schedule

PUT/v1/queue/slots

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Create a new queue or update an existing one. Without queueId, creates/updates the default queue. With queueId, updates a specific queue. With setAsDefault=true, makes this queue the default for the profile.

Body

queueIdstring

Queue ID to update (optional)

namestring

Queue name

timezonestringrequired

No description

slotsarrayrequired

No description

activeboolean

No description

setAsDefaultboolean

Make this queue the default

reshuffleExistingboolean

Whether to reschedule existing queued posts to match new slots

curl -X PUT "https://creatoros-production-5658.up.railway.app/v1/queue/slots" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "<timezone>",
    "slots": "<slots>"
  }'

Response 200

{
  "success": true,
  "schedule": "string",
  "nextSlots": [
    "string"
  ],
  "reshuffledCount": 0,
  "skippedDailyLimit": 0,
  "isNewQueue": true
}

Delete schedule

DELETE/v1/queue/slots

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Delete a queue from a profile. Pass queueId to delete a specific queue; omit it to delete all queues for the profile. If deleting the default queue, another queue will be promoted to default.

Query parameters

queueIdstring

Queue ID to delete. Omit to delete all queues for the profile

curl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/queue/slots" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "success": true,
  "deleted": true,
  "deletedCount": 0,
  "message": "string"
}

Get next available slot

GET/v1/queue/next-slot

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Returns the next available queue slot for preview purposes. To create a queue post, use POST /v1/posts with queuedFromProfile instead of scheduledFor.

Query parameters

queueIdstring

Specific queue ID (optional, defaults to profile's default queue)

curl "https://creatoros-production-5658.up.railway.app/v1/queue/next-slot" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "nextSlot": "string",
  "timezone": "string",
  "queueId": "string",
  "queueName": "string"
}

Preview upcoming slots

GET/v1/queue/preview

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Returns the next N upcoming queue slot times for a profile as ISO datetime strings.

Query parameters

queueIdstring

Filter by specific queue ID. Omit to use the default queue.

countstring

No description

curl "https://creatoros-production-5658.up.railway.app/v1/queue/preview" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "queueId": "string",
  "queueName": "string",
  "count": 0,
  "slots": [
    "string"
  ]
}

PreviousX (Twitter)NextMore analytics