> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Auto Schedule Overview

> Auto schedule lets you create posting schedules with times on chosen days and queue posts into the next available time slot via the Publish Post endpoint.

Auto scheduling allows you to create pre-defined posting schedules.
You can set up multiple schedules, each with specific posting times on chosen days.
Auto schedule is distinct from the `scheduleDate` field in the [Publish Post endpoint](https://www.ayrshare.com/docs/apis/post/post.md).

## Key Features of Auto Schedule

<ul>
  <li>Create custom schedules, e.g., post at 9 AM, 2 PM, and 5 PM on Mondays and Wednesdays.</li>
  <li>Posts are automatically queued in the next available time slot.</li>
  <li>No limit on the number of schedules you can create.</li>

  <li>
    Auto schedule is distinct from the `scheduleDate` field in the [Publish Post
    endpoint](https://www.ayrshare.com/docs/apis/post/post.md) and it is meant to automate scheduling. You should use either auto
    schedule or `scheduleDate`, but not both.
  </li>
</ul>

## Example Auto Schedule Scenario

1. Current time: Monday, 10 AM (GMT).
2. You create an auto schedule for posting at 9 AM and 5 PM.
3. You add three posts to this schedule.
4. The system automatically schedules these posts for: Monday at 5 PM, Tuesday at 9 AM, and Tuesday at 5 PM.

> [!NOTE]
>
> Deleting a scheduled post doesn't free up its time slot. For example, if you delete the Monday 5
> PM post and add a new post to the same schedule, it will be placed in the next available slot (in
> this case, Wednesday at 9 AM).

## Publish Using Auto Schedule

The schedule may be applied with the [Publish Post endpoint](https://www.ayrshare.com/docs/apis/post/post.md) using the following fields:

```json Auto Schedule theme={"system"}
"autoSchedule": {
   "schedule": true, // required
   "title": "Schedule Title" // optional - case-sensitive
}
```

<ul>
  <li>
    `schedule`: (required) A Boolean value that must be set to `true` to enable auto scheduling.
  </li>

  <li>
    `title`: (optional) A String value that specifies the name of the schedule. This `title` should
    match the name of a schedule created using the [Set Auto Schedule](https://www.ayrshare.com/docs/apis/auto-schedule/overview.md)
    endpoint. If not provided, the default title is `default`. Note that the `title` is
    case-sensitive and must be an exact match.
  </li>
</ul>

See your list of auto schedules by calling the [List Auto Schedules](https://www.ayrshare.com/docs/apis/auto-schedule/list-schedule.md) endpoint.

Please see this article on [using the auto scheduling API](https://www.ayrshare.com/blog/understanding-the-ayrshare-auto-schedule-api-endpoint/) for more information.

## User Profile Auto Schedule

Auto schedule for a particular user profile by [adding the PROFILE\_KEY in the header](https://www.ayrshare.com/docs/apis/overview.md#profile-key-format).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.