How to set up Pipecorn
Authentication
Pipecorn uses API key authentication:- Sign up at pipecorn.com
- Open Settings, then APIs, then Keys in app.pipecorn.com
- Create a key and copy it
- Paste the API key in Cargo when connecting
After connecting
Once the connector is set up, choose Pipecorn from the node catalog within a Play, Tool, or Agent.Pipecorn actions
Find LinkedIn profile from email
Find the person behind an email address, professional or personal. Required fields:- Email: the address to look up
- Full name, title and LinkedIn headline
- LinkedIn profile URLs, including the stable id-based one
- Current position, previous position and the full position history
- Company name and domain of the current position
- Location, connection and follower counts
Find email
Waterfall enrichment across Pipecorn’s providers for a professional email, returned synchronously. Required fields: either- LinkedIn URL, which is enough on its own
- or First name, Last name and one of Company domain or Company name
emailandemail_status:deliverable,catch-allwhen the domain accepts every address, ornullwhen no email was foundstatus:finishedonce the waterfall ran, even when nothing was found
Find phone
Waterfall enrichment across Pipecorn’s providers for phone numbers, returned synchronously. Required fields:- LinkedIn URL
- Phone type:
mobilekeeps only mobile numbers and keeps querying providers until one is found. Defaults toall - Phone country codes: ISO 3166-1 alpha-2 codes that restrict phone results
phonesin E.164 format,phone_detailswith each number’s line type, andphone_status
Find phone and email
Both of the above in one request, so the contact is enriched by a single node. Required fields:- LinkedIn URL, which both sides of the waterfall run off
- First name, Last name, Company domain and Company name, as extra signal for the email side
- Phone type and Phone country codes, as above
Find personal email
Waterfall enrichment across Pipecorn’s providers for a personal email, returned synchronously. Required fields:- LinkedIn URL
personal_emailandpersonal_email_status, which takes the same values asemail_status
Enrich account
Firmographics for one company. Required fields: one of- Company LinkedIn URL (regular or Sales Navigator)
- Domain
- Company name
- Country: ISO 3166-1 alpha-2 code to disambiguate the match
- Company name, description, industry and type
- Headcount, headcount range and headcount growth (month, quarter, year)
- Estimated revenue range and funding
- Headquarters and location
- Website, domain, LinkedIn URL, LinkedIn id and entity URN
Find people at company
Create a Pipecorn people search on one company and wait for it to finish. Required fields:- Company LinkedIn URL or Company LinkedIn ID
- At least one people filter: Job titles, Excluded job titles, Pipecorn persona ID, Functions, Seniority levels, Included location IDs or Excluded location IDs
- Limit: people returned for this company, 50 by default, 2500 at most
- Live LinkedIn search: off by default. On, the search runs on LinkedIn in real time through the synced session of the Pipecorn account; off, it runs on Pipecorn’s people database and needs no session
- Scale mode: raises volume by omitting connection counts, headlines and vanity profile URLs
lead holds the qualification status (QUALIFIED or DISQUALIFIED, with rejection reasons), name, title, headline, LinkedIn URLs and position history, and company holds the company the person was found at (name, website, LinkedIn URL and id, industry, employee range).
The search runs on Pipecorn’s side. Cargo checks it every 15 seconds and gives up after 10 minutes, then reads the people back page by page.
Without live LinkedIn search, a company that is not in Pipecorn’s database creates no search at all, and the action returns no people rather than failing.
Pipecorn credits: none. This draws on the extraction quota of your Pipecorn plan, and database searches are subject to the plan’s per-minute limit.
Use case: Build the buying committee at a target account from a persona you keep in Pipecorn.
Rate limits
Every endpoint the contact and account actions call spends credits and is exempt from Pipecorn’s per-plan rate limit; the connector paces requests at 60 per minute, the reverse lookup’s own limit. A people search without live LinkedIn search is the exception: it follows your plan’s per-minute limit (1 on Free, 2 on Basic, 10 on Starter and Premium, 100 or more above), and past it the node fails with a rate limit error.Best practices
- Pass a LinkedIn URL whenever you have one: it is the strongest identifier for every action
- Use
mobileas the phone type when the number is for calling, so landlines and VoIP numbers are dropped - Keep personas in Pipecorn and reference them by id, so one definition drives every search
- Branch on
email_statusandphone_statusbefore writing to a CRM - A
❌on a contact action always means the waterfall ran and found nothing: an enrichment Pipecorn could not complete fails the node instead, so it can be retried rather than recorded as a miss

