API reference
Queue
Each channel has posting times. The queue finds the next one that’s still free, so posts spread out instead of piling up.
Get the next free time
GET/api/public/v1/queue/next-slot
Returns the first of the channels’ posting times, after now, that none of them already has a post at. Pass several channels to find a time that suits all of them, then use it as scheduled_at when you create the post.
Query parameters
channel_ids[]array of integersRequired- The channels the post will go to.
afterstring- Look for a time after this one instead of after now, for example to fill next week.
curl -G https://api.postzora.com/api/public/v1/queue/next-slot \
-H "Authorization: Bearer $POSTZORA_API_KEY" \
--data-urlencode "channel_ids[]=12" \
--data-urlencode "channel_ids[]=15"const response = await fetch(`https://api.postzora.com/api/public/v1/queue/next-slot?${new URLSearchParams([['channel_ids[]', '12'], ['channel_ids[]', '15']])}`, {
headers: {
Authorization: `Bearer ${process.env.POSTZORA_API_KEY}`,
},
})
const { data } = await response.json()import os
import requests
response = requests.get(
"https://api.postzora.com/api/public/v1/queue/next-slot",
headers={"Authorization": f"Bearer {os.environ['POSTZORA_API_KEY']}"},
params={"channel_ids[]": ["12", "15"]},
)
data = response.json()["data"]Response
{ "data": { "scheduled_at": "2026-10-17T09:00:00Z" } }Questions about the API? Email [email protected].