Monitors

A monitor watches companies for new signals. Every morning at 09:00 UTC it checks each of its companies for each signal type it watches, and delivers what is new: by email (a daily digest to the workspace owner) or to your webhook. Everything it delivered stays readable in Signals.

Signal types: job_openings (hiring), financing_events (funding rounds), news_events (news) and connections (partnerships).

Cost#

Each company × signal type checked costs 1 credit per daily run, so a monitor watching 5 companies for hiring and funding costs 10 credits a day, every day, until you pause or delete it. A check that could not be made is refunded. A monitor's estimated_daily_cost is that number. If the workspace runs out of credits, its monitors pause themselves (paused_no_credits) and resume at the next run after you top up. A workspace can have up to 10 active monitors.

Who can do what#

Any token can read monitors and their runs (read). Creating, changing, pausing or deleting one, or changing its companies, needs a read_write token and its holder must be an owner or admin of the workspace, checked on every request: a token never outranks the person who made it.

Create a monitor#

job_opening_filters narrows hiring signals to some roles:

curl -X POST https://api.cornect.io/api/v1/monitors \
  -H "Authorization: Bearer cornect_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"name":"Competitors hiring sales","signal_types":["job_openings","financing_events"],"domains":["acme.com","globex.com"],"job_opening_filters":{"title_keyword":"sales"}}'

The response is the monitor (below), with status 201. This one costs 4 credits a day: 2 companies × 2 signal types.

List and get monitors#

List returns { items, total }; Get returns one monitor with its companies and its last 7 runs.

{
  "id": "3f1c2a9e-8b7d-4c6e-9a1b-2d3e4f5a6b7c",
  "name": "Competitors hiring sales",
  "signal_types": ["job_openings", "financing_events"],
  "delivery_method": "email",
  "webhook_id": null,
  "job_opening_filters": { "title_keyword": "sales", "seniority": [], "categories": [] },
  "status": "active",
  "last_run_at": "2026-10-11T09:00:34Z",
  "last_run_status": "success",
  "last_error": null,
  "domains": [
    { "domain": "acme.com", "added_at": "2026-10-10T14:02:11Z" },
    { "domain": "globex.com", "added_at": "2026-10-10T14:02:11Z" }
  ],
  "estimated_daily_cost": 4,
  "recent_runs": [],
  "created_at": "2026-10-10T14:02:11Z",
  "updated_at": "2026-10-10T14:02:11Z"
}

Update, pause and resume#

Send only the fields to change. Pause with {"status": "paused_by_user"} (no runs, no charges); resume with {"status": "active"}. A monitor paused for lack of credits cannot be resumed by hand: it resumes at the next run after a top-up.

curl -X PATCH https://api.cornect.io/api/v1/monitors/3f1c2a9e-8b7d-4c6e-9a1b-2d3e4f5a6b7c \
  -H "Authorization: Bearer cornect_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"status": "paused_by_user"}'

Add and remove companies#

Add one company per call, with body {"domain": "initech.com"}; its first check is at the next morning run, and the daily cost rises by 1 credit per signal type. Removing answers 204. A monitor that watches a list from the app takes its companies from that list, so both are refused with DOMAINS_FOLLOW_LIST.

curl -X POST https://api.cornect.io/api/v1/monitors/3f1c2a9e-8b7d-4c6e-9a1b-2d3e4f5a6b7c/domains \
  -H "Authorization: Bearer cornect_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"domain": "initech.com"}'

curl -X DELETE https://api.cornect.io/api/v1/monitors/3f1c2a9e-8b7d-4c6e-9a1b-2d3e4f5a6b7c/domains/initech.com \
  -H "Authorization: Bearer cornect_your_token_here"

Delete a monitor#

Deletes the monitor and its run history, and answers 204. Signals it already delivered stay in Signals. To stop the charges for a while instead, pause it.

Runs#

A monitor's daily runs, newest first (limit 1–200, offset; the response carries has_more), and one run check by check: each company and signal type, what it found, any error, and whether its credit was refunded.

Each check in a run's run_domains:

Errors#

Related#

• Signals
• Find New Leads
• Credits