GET /api/v1/app-states — List Connected Accounts

Returns app-states (connected social account sessions). App-state IDs are used as executor_ids when creating campaigns, post schedulers, and profile growth tasks.

The App States API returns the connected social account sessions for your ReachOwl account. App-state IDs are the values you pass as executor_id when creating campaigns, post schedulers, and profile growth tasks. App states are read-only: you cannot create or modify them via the API.

List App States

Endpoint

GET /api/v1/app-states

Request Example

curl -X GET 'https://reachowl.com/api/v1/app-states' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Response Example

{
  "data": [
    {
      "id": 5,
      "name": "Main Facebook Account",
      "platform": "facebook",
      "status": "active",
      "created_at": "2024-01-10T08:00:00Z"
    }
  ]
}

---

Get an App State

Endpoint

GET /api/v1/app-states/{id}

Path Parameters

id · integer · required

The unique identifier of the app state.

Request Example

curl -X GET 'https://reachowl.com/api/v1/app-states/5' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Response Example

{
  "id": 5,
  "name": "Main Facebook Account",
  "platform": "facebook",
  "status": "active",
  "created_at": "2024-01-10T08:00:00Z"
}

Save app-state IDs as executor_id values in your campaign, post scheduler, and profile growth creation requests.

App states are read-only. You cannot add, remove, or modify connected accounts via the API. Manage them in the ReachOwl dashboard.

Error Responses

Status	Description
401	Unauthorized
404	App state not found