Recurring Posts

Automatically publish the same post at regular intervals, indefinitely or until a specified stop condition.

Endpoint

POST /api/v1/posts/schedule

Request Headers

Header	Required	Description
Authorization	Yes	Bearer-API YOUR_API_KEY
Publer-Workspace-Id	Yes	Your workspace identifier
Content-Type	Yes	application/json
Accept	No	application/json (default)

Request Body

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"]
        }
      }
    ]
  }
}

Recurring Parameters

Field	Type	Description
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)

Examples

Weekly Recurring Post

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"]
      }
    }]
  }
}

Biweekly Recurring with Limit

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
      }
    }]
  }
}

How It Works

1. Create a post with recurring settings.

2. Schedule first occurrence at start_date.

3. Generate subsequent posts at each interval (repeat_every + frequency).

4. Stop when reaching occurrences count or passing end_date.

Platform Support

Platform	Recurring Support	Notes
Facebook	Full support	No special requirements
Instagram	Full support	No special requirements
LinkedIn	Full support	No special requirements
Twitter	Limited	Requires 10+ variations using Spintax Generator
Pinterest	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

Use Cases

• Regular reminders (e.g., weekly tips).

• Monthly newsletters or reports.

• Annual event notifications (e.g., holidays).

• Routine promotions or offers.

Best Practices

• 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 vs. Recycling

• Recurring Posts: Fixed dates/times on a repeating schedule.

• Recycling Posts: Fills open slots based on your posting calendar.

Related Topics

• Recycling Posts

• Scheduled Publishing

• Auto-Scheduling