Create and Manage Facebook Outreach Campaigns

Use ReachOwl outreach campaigns to automatically send friend requests and messages to members of Facebook groups. This guide walks you through the full lifecycle: discovering your synced groups, creating a campaign, controlling its status, and cloning it.

Find a Facebook group URL

Start by listing the groups already synced to your ReachOwl workspace. Each result includes the Facebook group URL you will target.

curl -X GET "{{baseUrl}}/api/v1/groups" \
  -H "Authorization: Bearer {token}"

{
  "data": [
    {
      "id": 1,
      "name": "Digital Marketing Pros",
      "group_url": "https://facebook.com/groups/digimarketpro"
    }
  ]
}

Copy the group_url value from the group you want to target.

Get executor IDs

Campaigns need at least one browser executor. List available executors from your app states and pick an id.

curl -X GET "{{baseUrl}}/api/v1/app-states" \
  -H "Authorization: Bearer {token}"

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

Save the id of an active executor for the next step.

Create the campaign

Send a POST request to /api/v1/campaigns with your audience settings, messenger sequence, and daily limit. The default limit is 30 contacts per day if you omit the field.

curl -X POST "{{baseUrl}}/api/v1/campaigns" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Campaign",
    "team_id": 3,
    "platform": "facebook",
    "action_type": "friend_request",
    "audience_type": "group",
    "post_url": "https://facebook.com/groups/digimarketpro",
    "executor_ids": [101],
    "messages": [
      "Hi {{first_name}}, thanks for being part of the community!"
    ],
    "schedule": "0 9 * * *",
    "limit": 30
  }'

{
  "id": 42,
  "name": "Welcome Campaign",
  "status": 1,
  "limit": 30
}

You can personalize message content with variables like and .

Pause or resume

Update the campaign status through a PATCH request instead of using a dedicated pause endpoint. Send status: 0 to pause or status: 1 to resume.

curl -X PATCH "{{baseUrl}}/api/v1/campaigns/42" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"status": 0}'

curl -X PATCH "{{baseUrl}}/api/v1/campaigns/42" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"status": 1}'

Clone a campaign

You can duplicate an existing campaign, including its messages and schedule, by including a clone_from field in the POST body instead of calling a separate clone endpoint.

curl -X POST "{{baseUrl}}/api/v1/campaigns" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Campaign - Copy",
    "clone_from": 42,
    "team_id": 3
  }'

{
  "id": 43,
  "name": "Welcome Campaign - Copy",
  "status": 1
}

There are no separate /pause, /resume, or /clone routes in the ReachOwl v1 API. Always use the update body fields shown above.

Getting Started

Concepts

Guides

Api Reference

Create and Manage Facebook Outreach Campaigns