GET /api/v1/groups — List Synced Facebook Groups

Returns the list of Facebook groups synced to your account. Groups are read-only. Use group_url values when creating campaigns or post schedulers.

The Groups API returns the Facebook groups that have been synced to your ReachOwl account. Groups are read-only resources: you cannot add, remove, or modify them via the API. Use the group_url field when creating campaigns or post schedulers.

Endpoint

GET /api/v1/groups

Query Parameters

page · integer

The page number for paginated results.

limit · integer

The number of results per page.

search · string

Filter groups by name or URL.

Request Example

curl -X GET 'https://reachowl.com/api/v1/groups?limit=10&page=1' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

Response Example

{
  "data": [
    {
      "id": 1,
      "name": "Digital Marketing Pros",
      "group_url": "https://facebook.com/groups/digitalmarketing",
      "members_count": 15420,
      "created_at": "2024-01-10T08:00:00Z"
    }
  ],
  "current_page": 1,
  "last_page": 3,
  "per_page": 10,
  "total": 25
}

Groups are read-only. You cannot add or remove groups via the API. Manage group syncing in the ReachOwl dashboard.

Error Responses

Status	Description
401	Unauthorized - Invalid or missing Bearer token