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

# Sync researched contacts to CRM

> Research contacts via the API, then export org contacts for CRM or warehouse sync without spending extra credits.

RevOps teams often research in Seamless, then sync enriched records into Salesforce, HubSpot, or a warehouse. The API supports this with **research** (spend credits once) and **org data** (read already-researched records without new research).

## Flow

```mermaid theme={null}
sequenceDiagram
  participant Job as Your job
  participant API as Seamless API
  participant CRM as CRM / warehouse
  Job->>API: Search + research (batch)
  Job->>API: Poll until done
  Job->>API: GET /contacts (org data)
  Job->>CRM: Upsert enriched rows
```

## Step 1 — Research new leads

Follow [Enrich a lead list](/use-cases/enrich-a-lead-list) or the [contact workflow](/end-to-end-contact-workflow) to research contacts and wait until poll status is `done`.

## Step 2 — Export org contacts

After research completes, records live in your org. Fetch them with [Get org contacts](/reference/getcontacts):

```bash theme={null}
curl -X GET "https://api.seamless.ai/api/client/v1/contacts?limit=50" \
  -H "Token: $SEAMLESS_API_KEY"
```

```python theme={null}
import os
import requests

response = requests.get(
    "https://api.seamless.ai/api/client/v1/contacts",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    params={"limit": 50},
)
response.raise_for_status()
for contact in response.json().get("data", []):
    print(contact.get("fullname"), contact.get("email"))
```

<Info>
  Org endpoints return contacts you have already researched. They do not accept `searchResultId` or `requestId`. No additional research credits are consumed on read.
</Info>

## Step 3 — Map fields to your CRM

Map Seamless fields to your CRM object (for example `email`, `phone`, `title`, `company`). In the Seamless app you can also import using CRM integrations — see the knowledge base article on [importing into your CRM](https://seamless.ai/customers/education).

## When to use org data vs research

| Situation                                 | Endpoint                         |
| ----------------------------------------- | -------------------------------- |
| New targets from search                   | Search → Research → Poll/webhook |
| Nightly sync of already enriched contacts | GET org contacts / companies     |
| Re-fetch after manual research in the app | GET org contacts                 |

## Related

* [Choose a workflow](/choose-the-right-workflow)
* [Get org companies](/reference/getcompanies)
