Executors: Connected Social Accounts in ReachOwl

Executors are connected browser sessions (app-states) that ReachOwl uses to perform campaign actions on Facebook or Instagram.

Executors are the social accounts and browser sessions that ReachOwl uses to carry out campaign actions. When you create a campaign, post-scheduler, or profile-growth job, you assign one or more executors so ReachOwl knows which account should send friend requests, messages, or posts. This page explains what executors are, how they are managed, and how you reference them in API calls.

App-states

App-states represent the authenticated social sessions ReachOwl maintains for you. Each app-state corresponds to a logged-in Facebook or Instagram account. ReachOwl uses these sessions to perform actions on your behalf.

You cannot create or update app-states through the API. They are read-only resources managed by ReachOwl. You list them with GET /api/v1/app-states to see which accounts are available and obtain their IDs.

Browsers

Behind each app-state is a browser session. Browsers are also read-only through the API. They represent the underlying browser profiles ReachOwl uses to isolate sessions. You can inspect browsers with GET /api/v1/browsers, but you cannot create or modify them via the API.

Referencing executors in requests

When you create a campaign, post-scheduler, or profile-growth job, you pass executor_ids in the request body. The values are the id fields returned by GET /api/v1/app-states.

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

A typical response looks like this:

{
  "data": [
    {
      "id": 1,
      "platform": "facebook",
      "name": "Main Business Account",
      "status": "active"
    }
  ]
}

Use the id values as executor_ids when creating resources:

{
  "executor_ids": [1]
}

Best practices

• Assign at least one active executor to every campaign or job. Without executors, ReachOwl has no account to perform actions.
• Verify the app-state platform matches the resource platform. A Facebook app-state should be used for Facebook campaigns.
• App-states and browsers are read-only via the API. If you need a new account connected, do so through the ReachOwl dashboard.

Related endpoints

• /api-reference/app-states — list available app-states
• /api-reference/browsers — list browser sessions