LeadOcean + Pipedrive: Enrich Records Automatically

You get a nightly job that fills the gaps in Pipedrive. It reads people that have a LinkedIn URL, sends each to LeadOcean, and writes the work email and phone back with Pipedrive's update-person call. LeadOcean is a plain REST API, so any script that can make HTTP calls does it. The Free plan covers a first run of 1,000 records.

Related: the integrations hub, Retool, Notion, Folk and pricing.

How it works

The job reads from Pipedrive, enriches at LeadOcean and patches the same person back. Updating by person id is the dedupe: the job never creates a record, so it cannot create a duplicate. Each person is read once and written once, and a person that already has an email is skipped, so a second night costs nothing for people you already filled.

1. Get a LeadOcean key. Sign up at app.leadocean.io, open API keys and copy one.
2. Add a custom field in Pipedrive. Create a text field called LinkedIn URL on People and fill it for the people you want enriched. Pipedrive refers to custom fields by a generated 40-character key, so copy that key from the field settings.
3. Copy your Pipedrive API token. Pipedrive takes it in the x-api-token header. The token belongs to one user and gives access to all of that user's data, so use a dedicated user.
4. Read people. Call GET /api/v2/persons with limit=500 and custom_fields set to your key, then page with cursor. Skip people with no LinkedIn URL or an email already.
5. Enrich each person. Call POST /v1/people/enrich with the linkedin_url and reveal_email: true. A person LeadOcean holds nothing for returns 404 and costs nothing.
6. Patch the person. Call PATCH /api/v2/persons/{id} with emails and phones.
7. Schedule it. Run the script from cron or any scheduler once a night. Filtering on an empty email means each person is enriched once. Pipedrive also has webhooks under Tools and apps, if you would rather trigger on new people.

Configuration

The script below is the whole job. Set LEADOCEAN_API_KEY, PIPEDRIVE_TOKEN, PIPEDRIVE_DOMAIN (your company domain) and LI_FIELD (the custom field key) in the environment.

import os, requests

LO = "https://api.leadocean.io"
PD = f"https://{os.environ['PIPEDRIVE_DOMAIN']}.pipedrive.com/api/v2"
LI = os.environ["LI_FIELD"]
lo = {"x-api-key": os.environ["LEADOCEAN_API_KEY"]}
pd = {"x-api-token": os.environ["PIPEDRIVE_TOKEN"]}

cursor = None
while True:
    params = {"limit": 500, "custom_fields": LI}
    if cursor:
        params["cursor"] = cursor
    page = requests.get(f"{PD}/persons", headers=pd, params=params).json()
    for p in page["data"]:
        url = (p.get("custom_fields") or {}).get(LI)
        has_email = any(e.get("value") for e in p.get("emails") or [])
        if not url or has_email:
            continue
        e = requests.post(f"{LO}/v1/people/enrich", headers=lo,
            json={"linkedin_url": url, "reveal_email": True})
        if e.status_code == 404:
            continue                      # nobody matched, nothing billed
        e.raise_for_status()
        d = e.json()["data"]["contact_data"]
        emails = d.get("contact_emails") or []
        phones = d.get("contact_phones") or []
        body = {}
        if emails:
            body["emails"] = [{"value": emails[0]["email"], "primary": True, "label": "work"}]
        if phones:
            body["phones"] = [{"value": phones[0]["phone"], "primary": True, "label": "work"}]
        if body:
            requests.patch(f"{PD}/persons/{p['id']}", headers=pd, json=body).raise_for_status()
    cursor = (page.get("additional_data") or {}).get("next_cursor")
    if not cursor:
        break

Test the LeadOcean key first with one call:

curl -X POST https://api.leadocean.io/v1/people/enrich \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url": "https://www.linkedin.com/in/jane-doe", "reveal_email": true}'

Send exactly one identifier per call: linkedin_url, email, phone or person_id. reveal_email: true costs no extra record. Pipedrive v2 returns the next page marker as additional_data.next_cursor, and it is null on the last page (Pipedrive pagination, October 2026).

Field mapping

The enrich response has success, data and meta. Emails and phones are arrays, so the script takes the first item.

Cost at 10,000 rows

Enriching 10,000 Pipedrive people costs LeadOcean one Solo month at $97, and about 50,200 Pipedrive API tokens. The Free plan covers the first 1,000 records, once.

Rows with no match are 404s and cost nothing, so 10,000 is a ceiling. Paid plans have no credits and no overage invoice. Agency at $497 a month suits teams that enrich across many sellers.

Pipedrive meters API calls in tokens (Source: Pipedrive rate limiting, September 2026). The daily budget is 30,000 base tokens times a plan multiplier times seats: Lite 1, Growth 2, Premium 5, Ultimate 7. When it runs out, calls return 429 until midnight server time.

The reference lists the v2 list call at 10 tokens and update-person at 5 (Pipedrive Persons API, October 2026). Reading 10,000 people at 500 a page is 20 calls, 200 tokens. Patching them is 50,000. One Lite seat has 30,000 a day, so the run takes two nights. A Growth seat (60,000) does it in one.

Seats are the larger bill, and this job does not add any. It runs as one dedicated user.

Troubleshooting

FAQ