Automatically publish the same post at regular intervals, indefinitely or until a specified stop condition.
POST /api/v1/posts/schedule
Authorization
Yes
Bearer-API YOUR_API_KEY
Publer-Workspace-Id
Yes
Your workspace identifier
Content-Type
Yes
application/json
Accept
No
application/json
(default)
Include a recurring
object under each post:
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"default": {
"type": "status",
"text": "Weekly reminder: Check our latest updates every Monday!"
}
},
"accounts": [
{ "id": "ACCOUNT_ID" }
],
"recurring": {
"frequency": "Week",
"repeat_every": 1,
"start_date": "2025-06-02T09:00:00Z",
"weekdays": ["Monday"]
}
}
]
}
}
frequency
string
Unit of recurrence: Day
, Week
, Month
, or Year
repeat_every
integer
Interval between posts (e.g., 1
for every week, 2
for every 2 weeks)
start_date
string
ISO 8601 timestamp for the first occurrence
weekdays
array
Days of week for weekly recurrence (e.g., ["Monday", "Wednesday"]
)
days
array
Days of month for monthly/yearly recurrence (e.g., [1, 15, 28]
)
end_date
string
ISO 8601 timestamp to stop recurrence (optional)
occurrences
integer
Maximum number of total occurrences (optional)
Every Monday at 9:00 AM:
{
"bulk": {
"state": "scheduled",
"posts": [{
"networks": {
"facebook": {
"type": "status",
"text": "Weekly reminder: Check our latest updates every Monday!"
}
},
"accounts": [{
"id": "66f509f7db2797026a37ba76"
}],
"recurring": {
"frequency": "Week",
"repeat_every": 1,
"start_date": "2025-06-02T09:00:00Z",
"weekdays": ["Monday"]
}
}]
}
}
Every other Tuesday and Thursday, for 10 occurrences:
{
"bulk": {
"state": "scheduled",
"posts": [{
"networks": {
"facebook": {
"type": "status",
"text": "Biweekly product update: See what's improved!"
}
},
"accounts": [{
"id": "66f509f7db2797026a37ba76"
}],
"recurring": {
"frequency": "Week",
"repeat_every": 2,
"start_date": "2025-06-03T15:30:00Z",
"weekdays": ["Tuesday", "Thursday"],
"occurrences": 10
}
}]
}
}
Create a post with recurring
settings.
Schedule first occurrence at start_date
.
Generate subsequent posts at each interval (repeat_every
+ frequency
).
Stop when reaching occurrences
count or passing end_date
.
Platform
Recurring Support
Notes
Full support
No special requirements
Full support
No special requirements
Full support
No special requirements
Limited
Requires 10+ variations using Spintax Generator
Limited
Requires 10+ variations using Spintax Generator
Google Business Profile
Limited
Requires 10+ variations using Spintax Generator
YouTube
Not supported
API limitations
TikTok
Not supported
API limitations
WordPress
Not supported
API limitations
Regular reminders (e.g., weekly tips).
Monthly newsletters or reports.
Annual event notifications (e.g., holidays).
Routine promotions or offers.
Evergreen Content: Use for timeless messages that benefit from repetition.
Stop Conditions: Always set end_date
or occurrences
to avoid indefinite runs.
Combine Actions: Add follow-up comments or auto-deletion for full lifecycle management.
Audience Consideration: Avoid fatigue by spacing posts appropriately.
Recurring Posts: Fixed dates/times on a repeating schedule.
Recycling Posts: Fills open slots based on your posting calendar.