> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add to watchlist

> Subscribe a company to Smart Sentinel monitoring.

Adds a company to your monitoring watchlist. Once added, Smart Sentinel agents begin running checks against the company on their configured cadence.

Provide at least one of `vendorId` or `rcNumber`. If a monitoring profile does not yet exist for the company it is created and the response returns `201`; otherwise your customer ID is attached to the existing profile and the response returns `200`.

## Body

<ParamField body="vendorId" type="string">
  The vendor ID to monitor. Required if `rcNumber` is omitted.
</ParamField>

<ParamField body="rcNumber" type="string">
  The company's RC number. Required if `vendorId` is omitted.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.vouchmark.com/v1/monitoring/vendors/watchlist \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{"vendorId":"cmp_aBcD..."}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "vendorId": "cmp_aBcD...",
      "rcNumber": "8511136",
      "customerIds": ["usr_aBcD..."],
      "profileCreated": true,
      "alreadyOnWatchlist": false
    }
  }
  ```
</ResponseExample>

`rcNumber` may be `null`. `profileCreated` is `true` when a new monitoring profile was created (`201`), `false` otherwise (`200`). `alreadyOnWatchlist` is `true` if your customer ID was already attached to the profile.