> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```http theme={null}
GET /api/v1/groups
```

## Query Parameters

<ParamField query="page" type="integer">
  The page number for paginated results.
</ParamField>

<ParamField query="limit" type="integer">
  The number of results per page.
</ParamField>

<ParamField query="search" type="string">
  Filter groups by name or URL.
</ParamField>

## Request Example

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

## Response Example

```json theme={null}
{
  "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
}
```

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

## Error Responses

| Status | Description                                    |
| ------ | ---------------------------------------------- |
| 401    | Unauthorized - Invalid or missing Bearer token |