POST /api/v1/post-scheduler - Create or Clone a Post Scheduler

Create a post scheduler for Facebook groups or Facebook profiles. Supports interval or calendar schedules, and clone_from.

Create a post scheduler that publishes to Facebook groups or to one or more Facebook profiles. Clone an existing scheduler with clone_from.

Create a new post scheduler, or clone an existing one with clone_from. Each scheduler targets one destination mode:

• Groups - post to Facebook group URLs (group_urls / group_ids) with an executor_id
• Profile - post to the timeline of one or more connected Facebook accounts (post_to_profile + profile_account_ids)

You cannot mix groups and profiles in a single scheduler. Choose one mode per create request.

Create a new scheduler

Body parameters

Field	Type	Required	Description
name	string	yes	Name of the post scheduler.
team_id	integer	yes	Team the scheduler belongs to.
post_to_profile	boolean	no	false (default) posts to Facebook groups. true posts to Facebook profile timelines.
executor_id	integer	groups mode	App-state ID that publishes the posts. Required for groups mode. For profile mode, omit or set to the first profile_account_ids entry.
group_urls	array	groups mode	Facebook group URLs to post to. Preferred over group_ids. Ignored when post_to_profile is true.
group_ids	string	no	Comma-separated internal group IDs already synced to your account.
profile_account_ids	array	profile mode	App-state IDs of Facebook accounts whose profiles should receive the posts. From GET /api/v1/app-states where platform is facebook.
schedule_type	string	yes	interval (minutes between posts) or calendar (fixed dates via calendar_items).
interval	integer	if interval	Minutes between queue items.
calendar_items	array	if calendar	Each item has id, startDate, and optional destination_type of group or profile.
posts	array	yes	Post objects. Each item needs a text string and may include an image upload for image posts.

Example - Facebook groups (interval)

curl -X POST "https://reachowl.com/api/v1/post-scheduler" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily Promos",
    "executor_id": 5,
    "team_id": 1,
    "post_to_profile": false,
    "group_urls": [
      "https://www.facebook.com/groups/group1",
      "https://www.facebook.com/groups/group2"
    ],
    "schedule_type": "interval",
    "interval": 180,
    "posts": [
      { "text": "Check out our latest feature!" }
    ]
  }'

Example - Facebook profiles (interval)

curl -X POST "https://reachowl.com/api/v1/post-scheduler" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Profile Updates",
    "team_id": 1,
    "post_to_profile": true,
    "profile_account_ids": [55, 56],
    "schedule_type": "interval",
    "interval": 180,
    "posts": [
      { "text": "Hello from my Facebook profile!" }
    ]
  }'

Example response (201)

{
  "status": "success",
  "message": "Post scheduler saved successfully",
  "post_scheduler": {
    "id": 42,
    "name": "Profile Updates",
    "team_id": 1,
    "executor_id": 55,
    "post_to_profile": true,
    "profile_account_ids": [55, 56],
    "schedule_type": "interval",
    "interval": 180,
    "status": 1
  }
}

Queued rows use destination_type of group or profile. Profile rows also store profile_fb_id when available.

Clone an existing scheduler

Use clone_from to duplicate an existing scheduler (including destination mode, groups, and posts).

Body parameters

Field	Type	Required	Description
clone_from	integer	yes	ID of the existing scheduler to clone.
name	string	no	Name for the clone. If omitted, the API appends (Copy) to the original name.
executor_id	integer	no	Optional override for the executor on the clone.
team_id	integer	no	Team for the cloned scheduler.

Example request

curl -X POST "https://reachowl.com/api/v1/post-scheduler" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "clone_from": 42,
    "name": "Profile Updates - Copy",
    "team_id": 1
  }'