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

# POST /api/v1/mentions — Create or Update a Keyword Monitor

> Create a new keyword mention monitor or update an existing one. Include id in the body to update. Use status 0 to disable a monitor.

Create a new keyword mention monitor to watch for posts containing specific keywords in Facebook groups. To update an existing monitor, include its `id` in the request body. ReachOwl does not expose PUT or PATCH endpoints for mentions; all create and update operations use POST.

## Body parameters

<ParamField body="id" type="integer">
  The ID of an existing monitor to update. Omit this field when creating a new monitor.
</ParamField>

<ParamField body="team_id" type="integer" required>
  Team the monitor belongs to.
</ParamField>

<ParamField body="type" type="string">
  Monitor type, such as `"facebook_groups"`.
</ParamField>

<ParamField body="keywords" type="array">
  Array of keyword strings to watch for in posts.
</ParamField>

<ParamField body="groups" type="array">
  Array of group IDs to scope the monitor to.
</ParamField>

<ParamField body="status" type="integer">
  Monitor status: `1` for active, `0` for disabled.
</ParamField>

## Create a monitor

```bash theme={null}
curl -X POST "https://reachowl.com/api/v1/mentions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "team_id": 1,
    "type": "facebook_groups",
    "keywords": ["SaaS", "growth"],
    "groups": [12, 34],
    "status": 1
  }'
```

## Update or disable a monitor

Include `id` in the body to update an existing monitor. Set `status` to `0` to disable it.

```bash theme={null}
curl -X POST "https://reachowl.com/api/v1/mentions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 88,
    "team_id": 1,
    "type": "facebook_groups",
    "keywords": ["SaaS", "growth", "AI"],
    "groups": [12, 34],
    "status": 0
  }'
```