Get Started with ReachOwl API

The ReachOwl API is a direct HTTP API. There is no package to install. All you need is any HTTP client (curl, Postman, Insomnia, or your language’s built-in HTTP library) and your ReachOwl credentials.

Prerequisites

A ReachOwl account (any plan)
Your account email and password
At least one connected browser with a linked Facebook account (visible in your dashboard under Browsers)

Get started

Authenticate

Exchange your email and password for a Bearer token. No special headers are needed for this request.

curl -X POST "https://reachowl.com/api/v1/authenticate" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your_password"
  }'

{
  "token": "2521|R4ek1kqRMr1XeemICKF3p8tIZ14Hw5qjTvixdUpm..."
}

Save the token value. You will pass it as Authorization: Bearer {token} on every subsequent request.

Get your team ID

Fetch your user profile to find your team_id. You need this when creating campaigns and querying contacts.

curl "https://reachowl.com/api/v1/user" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

{
  "id": 42,
  "email": "you@example.com",
  "team_id": 10
}

Note the team_id value.

Find your executor IDs

List your connected social accounts (app-states). Each entry has an id that you pass as executor_ids when creating a campaign.

curl "https://reachowl.com/api/v1/app-states" \
  -H "Authorization: Bearer {token}" \
  -H "Accept: application/json"

[
  {
    "id": 55,
    "platform": "facebook",
    "status": "active"
  }
]

Save one or more id values as your executor IDs.

Create a campaign

Create a Facebook group outreach campaign. Replace post_url with a synced group URL from GET /api/v1/groups.

curl -X POST "https://reachowl.com/api/v1/campaigns" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "My First Campaign",
    "team_id": 10,
    "platform": "facebook",
    "action_type": "friend_request",
    "audience_type": "group",
    "post_url": "https://www.facebook.com/groups/123456789",
    "executor_ids": [55],
    "messages": [
      {
        "text": ["Hi {{first_name}}, great to connect!"],
        "delay": 0
      }
    ],
    "schedule": [
      {
        "day": "Monday",
        "start_time": "09:00:00",
        "end_time": "17:00:00"
      }
    ]
  }'

A 201 response includes the new campaign object with its id. The campaign starts running immediately (status: 1). To pause it, send PATCH /api/v1/campaigns/{id} with {"status": 0}.

Next steps

Authentication

Learn how tokens work and best practices for storing them.

Campaigns

Understand action types, scheduling, limits, and cloning.

Post Scheduler

Schedule recurring posts to Facebook groups.

API Reference

Browse every endpoint with request and response details.

Getting Started

Concepts

Guides

Api Reference

Prerequisites

Get started

Next steps

Authentication

Campaigns

Post Scheduler

API Reference

​Prerequisites

​Get started

​Next steps

Authentication

Campaigns

Post Scheduler

API Reference

Prerequisites

Get started

Next steps