POST
/
auto-schedule
/
set
Available on Premium, Business, Enterprise plans.

Set up an auto-post schedule by providing times to send. Post will automatically be sent at the next available time. If no more times are available today, the first available time tomorrow will be used, and so on.

If you’re looking to just schedule a post for a future date, please see the scheduleDate parameter of /post

Use the auto-schedule by setting the /post autoSchedule parameter to true and the title if you want to use a particular schedule. Example, set the times to UTC time 13:05Z and 20:14Z and autoSchedule: true in the post. The post will be scheduled at the next available time of 13:05Z or 20:14Z.

Header Parameters

Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Body Parameters

schedule
array
required

Array of strings of scheduled times to auto-post. The array will be treated as a set, so duplicates removed.

Format: ISO-8601 UTC. Example: ["13:05Z", "22:14Z"]. Not required if setStartDate provided.

title
string
default: "default"

Multiple schedules can be set by providing a title for each schedule. If you specify the title in /post with autoScheduleTitle, that schedule will be used.

setStartDate
string

Set a specific beginning date to start the auto schedule, provide a ISO-8601 UTC date time. E.g. 2021-07-08T12:30:00Z. The start time will be applied to the provided “title” or will use the default title if one isn’t provided.

New posts will go out from the start date onwards. Previously scheduled posts are not affected.

daysOfWeek
array
default: [0,6]

Specify which days of the week the post should be sent. Values 0-6 (Sunday - Saturday). For example [1, 3] will only publish posts on Mondays and Wednesdays.

excludeDates
array

Exclude certain dates from auto scheduling occurring. For example ["2026-01-01"] to exclude New Years.

Note, only posts auto scheduled after the excludeDates has been set will be excluded.