Queue & Scheduling

The queue lets you schedule recurring publications without managing time zones.

Create a schedule

POST /v1/queue
{
  "name": "Daily posts",
  "timezone": "Europe/Paris",
  "slots": [
    { "day": "mon", "time": "09:00" },
    { "day": "mon", "time": "12:30" },
    { "day": "mon", "time": "18:00" },
    { "day": "tue", "time": "09:00" }
  ],
  "platforms": ["twitter", "linkedin"]
}

Add content to the queue

POST /v1/queue/{queueId}/items
{
  "text": "Tip of the day",
  "mediaUrls": ["https://example.com/tip.jpg"]
}

The post will be published at the next available slot.

Best times to post

pepe.business analyzes past engagement and suggests the best slots:

GET /v1/analytics/best-times?platform=instagram

{
  "bestTimes": [
    { "day": "mon", "time": "12:00", "score": 0.92 },
    { "day": "wed", "time": "18:30", "score": 0.88 },
    { "day": "fri", "time": "09:00", "score": 0.85 }
  ]
}

You can create a queue that automatically follows these recommendations with autoOptimize: true.

Timezones

All times are in 24h format in the configured timezone. List of supported timezones: IANA TZ database.

Next available slot

GET /v1/queue/{queueId}/next-slot

{
  "nextSlot": "2026-07-14T09:00:00+02:00",
  "queueDepth": 3
}

Preview upcoming

GET /v1/queue/{queueId}/preview?days=14

Returns the list of publications planned for the next 14 days.