---
title: "Start monitoring people (URLs) or the person of a Person Intelligence report"
method: POST
path: "/api/me/intelligence/monitoring"
tags: ["me", "intelligence"]
---

# Start monitoring people (URLs) or the person of a Person Intelligence report

`POST /api/me/intelligence/monitoring`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/intelligence/monitoring`
- Auth: none declared

inputs: up to 1,000 LinkedIn profile URLs; or snapshotId to monitor the person of an existing report (the first weekly check then skips the month backfill the report already covered). periodDays 30 | 90 | 180 | null (forever), default 90. admitLevel 2 | 3 (default 2): 3 also delivers topic interest (content about your space with no stated need) as topic-interest signals from strength 5. Best-effort per row; see skipped[].

## Request body

- CreateMonitoringBody
  - `inputs` string[]
  - `snapshotId` string, uuid
  - `periodDays` union: 30, 90 or 180 days; null means forever.
    - 30
    - 90
    - 180
  - `admitLevel` union: 2 (default): stated needs only — the person's activity becomes a signal when its text states a need, pain or buying moment your product addresses. 3: also topic interest — professional content about your category with no stated need, delivered as topic-interest signals with a lower strength floor (5 instead of 8).
    - 2
    - 3

## Response `200`

Per-row results

- CreateMonitoringResponse
  - `created` object[], required
    - `id` string, uuid, required
    - `linkedinUrl` string, required
    - `displayName` string, required
  - `skipped` object[], required
    - `input` string, required
    - `normalized` string
    - `reason` 'duplicate' | 'invalid_format' | 'already_active' | 'conflict' | 'ceiling_reached', required

## Other responses

- `400`: Validation error or too_many_inputs (>1,000)
- `404`: snapshotId not found in this workspace

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)