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": "recurring",
    "posts": [
      {
        "networks": {
          "default": {
            "type": "status",
            "text": "Weekly reminder: Check our latest updates every Monday!"
          }
        },
        "accounts": [
          { "id": "ACCOUNT_ID" }
        ],
        "recurring": {
          "start_date": "2025-06-05T13:29+02:00",
          "end_date": "2025-07-21T13:29+02:00",
          "repeat": "weekly",
          "days_of_week": [
            1,
            4,
            6
          ],
          "repeat_rate": 1
        }
      }
    ]
  }
}

Key Fields

• state: must be "recurring" for recurring posts

Recurring Parameters

Parameter	Type	Description	Example
start_date	string	ISO 8601 timestamp for the first occurrence	2025-06-05T13:29+02:00
end_date	string	ISO 8601 timestamp to stop recurrence (optional)	2025-07-21T13:29+02:00
repeat	string	The interval unit for repetition. Supported values: "daily", "weekly", "monthly", yearly	"weekly"
repeat_rate	integer	How often to repeat in the chosen interval. For example, 6 with "weekly" means every 6 weeks.	6
days_of_week[]	array	For weekly repeats, which days to schedule on. Values: [0, 1, 2, 3, 4, 5, 6]	[0,4]

Examples

Weekly Recurring Post

{
  "bulk": {
    "state": "recurring",
    "posts": [{
      "networks": {
        "facebook": {
          "type": "status",
          "text": "Weekly reminder: Check our latest updates every Monday!"
        }
      },
      "accounts": [{
        "id": "66f509f7db2797026a37ba76"
      }],
      "recurring": {   
        "start_date": "2025-06-05T13:29+02:00",
          "end_date": "2025-07-21T13:29+02:00",
          "repeat": "weekly",
          "days_of_week": [
            1
          ],
          "repeat_rate": 1
      }
    }]
  }
}

Biweekly Recurring with Limit

Every other Tuesday and Thursday:

{
  "bulk": {
    "state": "recurring",
    "posts": [{
      "networks": {
        "facebook": {
          "type": "status",
          "text": "Biweekly product update: See what's improved!"
        }
      },
      "accounts": [{
        "id": "66f509f7db2797026a37ba76"
      }],
      "recurring": {
        
        "start_date": "2025-06-05T13:29+02:00",
        "end_date": "2025-07-21T13:29+02:00",
        "repeat": "weekly",
        "days_of_week": [
          1,
          3,
        ],
        "repeat_rate": 1
      }
    }]
  }
}

How It Works

To create a recurring post, specify the recurrence parameters inside the recurring object:

• start_date: The date and time for the first occurrence.

• end_date: The last date and time for recurring posts to be generated.

• repeat: The repeat interval unit: "daily", "weekly", "monthly" or "yearly".

• repeat_rate: Frequency of the interval. For example, 1 with "weekly" means every week, 2 means every other week, etc.

• days_of_week: Which days of the week to post on (e.g., [1, 3] for Tuesday and Thursday).

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