# Auto-Scheduling

Automatically pick the optimal posting time for your content within a specified date window. Publer analyzes your posting schedule and audience engagement to fill gaps and maximize reach.

### Endpoint

```bash
POST /api/v1/posts/schedule
```

### Request Headers

<table><thead><tr><th width="195.8599853515625">Header</th><th width="137.239501953125">Required</th><th>Description</th></tr></thead><tbody><tr><td>Authorization</td><td>Yes</td><td><code>Bearer-API YOUR_API_KEY</code></td></tr><tr><td>Publer-Workspace-Id</td><td>Yes</td><td>Workspace ID</td></tr><tr><td>Content-Type</td><td>Yes</td><td><code>application/json</code></td></tr><tr><td>Accept</td><td>No</td><td><code>application/json</code> (default)</td></tr></tbody></table>

### Request Body

Set `auto: true` and define `range` to enable auto-scheduling:

```json
{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "status",
            "text": "Let Publer pick the best time for this post!"
          }
        },
        "accounts": [
          { "id": "ACCOUNT_ID" }
        ],
        "range": {
          "start_date": "2025-05-23T07:45:00Z",
          "end_date":   "2025-05-31T23:59:00Z"
        },
        "auto": true
      }
    ]
  }
}
```

#### Key Parameters

<table><thead><tr><th width="176.4857177734375">Field</th><th width="86.9464111328125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>auto</code></td><td>boolean</td><td>Set to <code>true</code> to enable auto-scheduling</td></tr><tr><td><code>range.start_date</code></td><td>string</td><td>Earliest ISO 8601 timestamp for posting (inclusive)</td></tr><tr><td><code>range.end_date</code></td><td>string</td><td>Latest ISO 8601 timestamp for posting (inclusive, optional)</td></tr><tr><td><code>share_next</code></td><td>boolean</td><td>(Optional) When <code>true</code>, schedule in the very next available slot</td></tr></tbody></table>

### Examples

#### Basic Auto-Scheduling

```json
{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "facebook": {
          "type": "status",
          "text": "Let Publer choose the best time!"
        }
      },
      "accounts": [{ "id": "66f509f7db2797026a37ba76" }],
      "range": {
        "start_date": "2025-05-23T07:45:00Z",
        "end_date":   "2025-05-31T23:59:00Z"
      },
      "auto": true
    }]
  }
}
```

#### Next Available Slot

Omit `end_date` and set `share_next` to schedule at the next open slot:

```json
{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "facebook": {
          "type": "status",
          "text": "Post in next available slot"
        }
      },
      "accounts": [{ "id": "66f509f7db2797026a37ba76" }],
      "range": { "start_date": "2025-05-23T07:45:00Z" },
      "share_next": true,
      "auto": true
    }]
  }
}
```

### How It Works

1. **Analyze Schedule**: Publer looks at your existing posting queue and calendar.
2. **Identify Slots**: Finds open time slots based on your account’s posting schedule.
3. **Optimize**: Uses audience engagement data to pick a high-impact time within your range.
4. **Schedule**: Creates the post at the selected time.

### Use Cases

* **Fill Gaps**: Keep your queue full without manual scheduling.
* **Engagement Boost**: Leverage data-driven timing for better reach.
* **Bulk Campaigns**: Auto-schedule large batches within a window.
* **Hands-Off Workflow**: Let Publer handle timing so you focus on content.

### Best Practices

* **Define Posting Schedule**: Ensure your account has active time slots configured.
* **Reasonable Ranges**: Provide a wide enough window for better slot selection.
* **Mix Methods**: Combine auto-scheduling with manual posts for flexibility.
* **Monitor Jobs**: Poll `/api/v1/job_status/{job_id}` to confirm success.

### Common Issues

<table><thead><tr><th width="177.87603759765625">Issue</th><th>Solution</th></tr></thead><tbody><tr><td>No available slots</td><td>Add or open time slots in your posting schedule within the date range.</td></tr><tr><td>Suboptimal timing</td><td>Expand the date range or refine your posting schedule.</td></tr><tr><td>Data insufficient</td><td>Post more content manually to build up engagement metrics.</td></tr></tbody></table>

### Related Topics

* [Publishing Methods](https://publer.com/docs/posting/create-posts/publishing-methods)
* [Scheduled Publishing](https://publer.com/docs/posting/create-posts/publishing-methods/manual-scheduling)
* [Recurring Posts](https://publer.com/docs/posting/create-posts/publishing-methods/recurring-posts)