SSalesCrew

Data sources · 10 min · reviewed 2026-09-06

How do I register a scraper or data source in a CRM?

A data source is any service that answers the scraper control API (/filters, /jobs, /jobs/{id}/results). Register its base URL and API key under Settings → Data sources & scrapers; its filters then appear as a form in Data Bank and finished rows flow into the CRM through the ingest envelope.

What you will need

  • Admin role.
  • The scraper's base URL and its X-API-Key, from whoever runs it.

Steps

  1. 1

    Step 1

    Settings → Data sources & scrapers → Register.

  2. 2

    Step 2

    Key: a short lowercase id such as linkedin-sales-nav. Label: what people see.

  3. 3

    Step 3

    Service base URL: https://scraper-host.example.com. API key: pasted as X-API-Key on every call.

  4. 4

    Step 4

    Completion mode: *webhook* if the scraper can call back to https://<your-workspace>/functions/v1/scraper-webhook, otherwise *poll*.

  5. 5

    Step 5

    Field mapping (optional): JSON that renames the scraper's columns to CRM fields.

  6. 6

    Step 6

    Save. The row shows Reachable once /filters answers.

Common errors

Unreachable
the URL is not public, or blocks the CRM's requests. Check from a browser first.
Filters empty
/filters returns an empty catalog. The scraper owner fills it.
Rows arrive without e-mails
mapping is missing for the e-mail column.

How you know it worked

Data Bank → New request lists the source with its filters. A small test job finishes and its rows appear.

Where this goes in SalesCrew

Settings → Data sources & scrapers → the row shows Reachable and its filters load. In your own workspace the same how-to opens beside the field, with your callback URLs filled in.

Related