Campaigns: How ReachOwl Automates Outreach

ReachOwl campaigns are the primary way you automate outreach on social platforms. When you create a campaign, you define the platform, audience source, action, connected account (executor), messages, and constraints like daily limits and schedules.

Platforms

`platform`	Typical use
`facebook`	Group members, post engagers, friends, CSV upload
`instagram`	Followers, following, comments, hashtag/location, CSV upload
`whatsapp`	Synced WhatsApp groups, or CSV / contact list upload

Action types

`action_type`	Platforms	Description
`messages`	All	Send a text message to each target. WhatsApp supports this only.
`friend_request`	Facebook, Instagram	Send a friend/follow request.
`comments`	Facebook, Instagram	Comment on posts when audience is comments.
`cancel_friend_request`	Facebook	Cancel pending friend requests.
`unfriend_friend`	Facebook	Unfriend filtered friends.
`unfollow_friend`	Instagram	Unfollow filtered accounts.

Audience types by platform

Platform	Supported `audience_type` values
Facebook	`group`, `reactions`, `comments`, `comments_video`, `friends`, `file_upload`, `pending_friend_requests`, `suggestions`
Instagram	`followers`, `following`, `comments`, `location`, `hashtag`, `file_upload`
WhatsApp	`group`, `file_upload`

For a synced WhatsApp group, set platform: "whatsapp", audience_type: "group", and pass the group id from Browsers sync as post_url (and/or group_id).
For a CSV or contact list, set audience_type: "file_upload". Create the campaign first, then upload rows with POST /api/v1/campaigns/{id}/contacts (or multipart urls_file after create). Use a phone or profile_url column for WhatsApp numbers.

You can refine audiences with audience_keywords and exclude_keywords (default []).

Status and control

You control a campaign lifecycle through the status field. There is no separate /pause or /resume endpoint.

Status	Meaning
`0`	Paused. The campaign will not perform actions until you set status to `1`.
`1`	Running. ReachOwl actively processes the campaign queue.

Create with POST /api/v1/campaigns, then set status with PATCH or PUT on /api/v1/campaigns/{id}. Clone with clone_from in the create body.

Daily limit

The limit field sets the maximum number of actions per day (default 30).

Schedule

Use the schedule array to restrict when actions are sent:

[
  {
    "day": "Monday",
    "start_time": "09:00",
    "end_time": "17:00"
  }
]

Messages and placeholders

Message campaigns send one or more messages entries. Each entry contains a text string array and an optional delay (minutes).

[
  {
    "text": ["Hi {{first_name}}, thanks for connecting!"],
    "delay": 0
  }
]

Personalize with {{first_name}} and any extra CSV column names declared in variables.

Executors

Link connected accounts with executor_ids from GET /api/v1/app-states. Use a WhatsApp-connected app-state for WhatsApp campaigns.

WhatsApp group example

curl -X POST "https://reachowl.com/api/v1/campaigns" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "WA Group Outreach",
    "team_id": 10,
    "platform": "whatsapp",
    "audience_type": "group",
    "action_type": "messages",
    "post_url": "120363012345678901@g.us",
    "executor_ids": [55],
    "limit": 30,
    "status": 1,
    "messages": [
      {
        "text": ["Hi {{first_name}}, quick note from our team."],
        "delay": 0
      }
    ],
    "schedule": [
      {
        "day": "Monday",
        "start_time": "09:00",
        "end_time": "17:00"
      }
    ]
  }'

WhatsApp CSV / contact list example

Create a campaign with audience_type: "file_upload".
Add contacts to that campaign:

curl -X POST "https://reachowl.com/api/v1/campaigns/101/contacts" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
    "audience": [
      {
        "name": "Ali Khan",
        "member_id": "923001234567@c.us",
        "profile_url": "https://wa.me/923001234567",
        "variables": { "area": "DHA Lahore" }
      }
    ]
  }'

WhatsApp rows should include a phone-style member_id (for example 923001234567@c.us) and/or profile_url like https://wa.me/923001234567.

Create campaign
Update campaign
List campaigns (filter with platform=whatsapp)
Get campaign
WhatsApp campaign guide

Getting Started

Concepts

Guides

Api Reference

Campaigns: How ReachOwl Automates Outreach

Platforms

Action types

Audience types by platform

Status and control

Daily limit

Schedule

Messages and placeholders

Executors

WhatsApp group example

WhatsApp CSV / contact list example

​Platforms

​Action types

​Audience types by platform

​Status and control

​Daily limit

​Schedule

​Messages and placeholders

​Executors

​WhatsApp group example

​WhatsApp CSV / contact list example

​Related endpoints

Platforms

Action types

Audience types by platform

Status and control

Daily limit

Schedule

Messages and placeholders

Executors

WhatsApp group example

WhatsApp CSV / contact list example

Related endpoints