Watchlists

List the CRM lists a watchlist can be built from

Build a watchlist from a list that already lives in your CRM, instead of sending the members inline — and keep the two in step as the segment moves.

Input: provider — hubspot (default) or pipedrive.

Output: sources[], each with sourceType and sourceListId to pass straight into a watchlist's config, plus name, size, watches (people for a Job Change Watchlist, companies for the company watchlists) and updatesItself (true when the list is rule-based, so its membership changes on its own).

An empty array means that CRM is not connected to your account. Connecting one is an interactive authorisation and is done in the dashboard — this endpoint only reads what is already connected. A 412 means the connection exists but was granted without permission to read lists; reconnect it from the dashboard.

Use cases:

  • Watch the champions in a closed-won list and hear the day one of them lands somewhere new — a warm introduction into a brand-new account.
  • Point a company watchlist at the target-account list your team already maintains, so the accounts you monitor never drift from the accounts you sell to.
  • Leave sourceDynamicSync on so a rule-based segment adds and removes watched records by itself, with no further API calls.
get/api/v1/watchlists/sources

Request

  • Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.rodz.io/api/v1/watchlists/sources
  • Auth: HTTP bearer

Query parameters

provider'hubspot' | 'pipedrive'

Which connected CRM to read.

Response

Successful Response

Example response

{
  "sources": [
    {
      "name": "Champions - closed won 2026",
      "size": 812,
      "sourceListId": "1274",
      "sourceType": "hubspot_list",
      "updatesItself": true,
      "watches": "people"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.