arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

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.

hashtag
Endpoint

hashtag
Request Headers

Header
Required
Description

hashtag
Request Body

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

hashtag
Key Parameters

Field
Type
Description

hashtag
Examples

hashtag
Basic Auto-Scheduling

hashtag
Next Available Slot

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

hashtag
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.

hashtag
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.

hashtag
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.

hashtag
Common Issues

Issue
Solution

hashtag
Related Topics

POST /api/v1/posts/schedule
Schedule: Creates the post at the selected time.
Hands-Off Workflow: Let Publer handle timing so you focus on content.
Monitor Jobs: Poll /api/v1/job_status/{job_id} to confirm success.

Authorization

Yes

Bearer-API YOUR_API_KEY

Publer-Workspace-Id

Yes

Workspace ID

Content-Type

Yes

application/json

Accept

No

application/json (default)

auto

boolean

Set to true to enable auto-scheduling

range.start_date

string

Earliest ISO 8601 timestamp for posting (inclusive)

range.end_date

string

Latest ISO 8601 timestamp for posting (inclusive, optional)

share_next

boolean

(Optional) When true, schedule in the very next available slot

No available slots

Add or open time slots in your posting schedule within the date range.

Suboptimal timing

Expand the date range or refine your posting schedule.

Data insufficient

Post more content manually to build up engagement metrics.

Publishing Methods
Scheduled Publishing
Recurring Posts
{
  "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
      }
    ]
  }
}
{
  "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
    }]
  }
}
{
  "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
    }]
  }
}