Import Contacts or Blocklist Data
Imports contacts or do-not-contact entries from a CSV, a hosted file, or an array. Set target 'contacts' to load CRM records (from raw CSV text, an HTTPS URL, a storage path, or contact objects), with control over how duplicate LinkedIn URLs are merged, replaced, or skipped. Set target 'blacklist' to add exclusion entries instead. Fails if the CSV is malformed.
Example prompt: Import this CSV of contacts from lemlist, merge duplicates, and add them to my Q3 prospects list
{
"target": "contacts",
"imported": 240,
"merged": 15,
"skipped": 3
}What you can build
Parameters
Inputs accepted by import_data.
| Name | Type | Description |
|---|---|---|
| target | "contacts" | "blacklist" | What to import: 'contacts' for CRM contacts, 'blacklist' for do-not-contact entries |
| contacts | object[] | Array of contact objects (for target='contacts'). Each must have a LinkedIn URL. |
| csv_content | string | Raw CSV or TSV text (for target='contacts') |
| csv_url | string | HTTPS URL of a CSV/TSV file (for target='contacts') |
| storage_path | string | Path inside the 'imports' Supabase Storage bucket (for target='contacts') |
| source | string | Where contacts came from, e.g. 'lemlist', 'heyreach' (for target='contacts') |
| list_id | string | Optional list ID, imported contacts are automatically added (for target='contacts') |
| entries | string[] | Blacklist entries: URL strings or {linkedin_url, reason} objects (for target='blacklist') |
| merge_strategy | "merge" | "replace" | "skip" | How to handle duplicate linkedin_url (target='contacts' only): 'merge' (default; tags UNION, attrs deep-merge), 'replace' (overwrite + null unspecified user-facing fields: first_name,last_name,email,company,title,phone,industry,location,country,status,source,source_detail,tags,custom_attrs,external_ids), 'skip' (no-op dupes). |
Related tools
Bulk Import Contacts
Bulk-import LinkedIn contacts from JSON, CSV, URL, or storage with merge, replace, or skip strategies. Preview before committing and track per-record skips.
Import Block List
Bulk import LinkedIn profiles to your do-not-contact block list from CSV or JSON, up to 5000 per call. Invalid and duplicate URLs are skipped.
List And Export Contacts
Query and export LinkedIn contacts with rich filters by connection status, campaign, tags, or custom attributes. Returns JSON or CSV for bulk export.
The complete LinkedIn API. Ready when you are.
Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.