Create and Manage Facebook Outreach Campaigns

Step-by-step guide to creating a Facebook group campaign in ReachOwl: set your audience, message sequence, schedule, and daily limit.

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.

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

   Request

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

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

2. Get executor IDs

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

   Request

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

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

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

   Request

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

   You can personalize message content with variables like and .

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

   Pause

   curl -X PATCH "{{baseUrl}}/api/v1/campaigns/42" \
     -H "Authorization: Bearer {token}" \
     -H "Content-Type: application/json" \
     -d '{"status": 0}'
   
5. 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.

   Request

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

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