POST
/
auto-schedule
/
set
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"schedule": ["13:05Z", "20:14Z"], "title": "Instagram Schedule"}' \
-X POST https://api.ayrshare.com/api/auto-schedule/set

{
    status: "success",
    message: "Auto schedule set.",
    title: "Instagram Schedule",
}
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"
You can create multiple different posting schedules by assigning a unique title to each one. The title must contain only alphanumeric characters - special characters like *, ~, /, [, or ] are not allowed.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.
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"schedule": ["13:05Z", "20:14Z"], "title": "Instagram Schedule"}' \
-X POST https://api.ayrshare.com/api/auto-schedule/set

{
    status: "success",
    message: "Auto schedule set.",
    title: "Instagram Schedule",
}