Monitor or stop accounts

Monitors or stops a selection of accounts in one business unit, and bills it right away: send signal_buckets: ["essential"] to monitor them, null to stop. Monitoring costs 50 credits per account and per business unit for a month.

Accounts are monitored through the lists attached to that business unit: an account that only sits on lists attached to no business unit is refused. When a list is attached to several business units, monitoring an account on it monitors, and charges, it in each of them. Stopping keeps the month already paid until its end and never refunds it.

The request is never refused for lack of credits: an account whose month cannot be paid comes back with the status not_covered in changed. The response tells what the request took from your balance in charged_credits. A request where every account is refused still answers 200. Every change is recorded, with who made it, in the membership log of the lists involved.

To monitor a whole list, including the accounts added to it later, set its signal_buckets with PUT /api/v3/lists/{kind}/{list_id}. See the account monitoring overview.

Route

Access modes

Use a workspace API key. The workspace is inferred from the key.

Authorization: Bearer sk_live_...

Body parameters

Example request

curl -X PUT "https://api.getsillage.com/api/v3/account-monitoring/accounts" \
  -H "Authorization: Bearer $SILLAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persona_id": 12,
    "company_ids": [
      301,
      302,
      303
    ],
    "signal_buckets": [
      "essential"
    ]
  }'

Success response

Status: 200 OK

{
  "data": {
    "changed": [
      {
        "company_id": 301,
        "status": "monitored",
        "covered_until": "2026-11-08T09:30:00.000Z"
      },
      {
        "company_id": 302,
        "status": "not_covered",
        "covered_until": null
      }
    ],
    "already_in_state": [303],
    "refused": [],
    "charged_credits": 50,
    "balance_after_credits": 950
  }
}

Response fields

Refusal reasons

Errors