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

id · integer

The ID of an existing monitor to update. Omit this field when creating a new monitor.

team_id · integer · required

Team the monitor belongs to.

type · string

Monitor type, such as "facebook_groups".

keywords · array

Array of keyword strings to watch for in posts.

groups · array

Array of group IDs to scope the monitor to.

status · integer

Monitor status: 1 for active, 0 for disabled.

Create a monitor

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.

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
  }'