AutoClip

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 key
GET

/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.json

Save 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.json

Save 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"