REST API · v1
Posting schedule
Queue slots decide when clips go out on each account. Campaign posts wait until the extension is online, so they can be submitted in time.
https://polished-turtle-977.convex.siteGet an API keyGET
/api/v1/queue-slots
Your weekly posting slots.
- Response shape
- { timezone, data: [{ id, socialAccountId, dayOfWeek: 0-6, time: "HH:mm" }] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/queue-slots' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"PUT
/api/v1/queue-slots
Replace one account's slots.
- Input
- { socialAccountId, slots: [{ dayOfWeek, time }] }
- Response shape
- same as GET
curl --request PUT 'https://polished-turtle-977.convex.site/api/v1/queue-slots' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY" \
--header "Content-Type: application/json" \
--data @request.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
POST
/api/v1/queue
Add clips to the posting queue. They publish publicly, so confirmation is required.
- Input
- { clipIds[], socialAccountIds[], confirm: true }
- Response shape
- { scheduled: [{ clipId, socialAccountId, scheduledFor, publishScheduleId }] }
This endpoint requires confirmation. Review the action before sending confirm: true.
curl --request POST 'https://polished-turtle-977.convex.site/api/v1/queue' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY" \
--header "Content-Type: application/json" \
--data @request.jsonSave the input fields as request.json before running a write request. Replace path placeholders with your own IDs.
GET
/api/v1/calendar
Scheduled posts in a date range (up to 62 days).
- Input
- ?from=&to= (ISO dates)
- Response shape
- { data: ScheduledPost[] }
curl --request GET 'https://polished-turtle-977.convex.site/api/v1/calendar' \
--header "Authorization: Bearer $AUTOCLIP_API_KEY"