Skip to main content

Link or create your contacts and companies in your CRM in bulk

Use Search and connect to match lemlist contacts and companies with records already in your CRM, or Create in CRM to also add the missing ones, from the app, the API or the lemlist MCP.

When contacts or companies in lemlist are not linked to your CRM yet, two bulk actions link them for you:

  • Search and connect finds each record in your CRM and links it. It never creates anything in the CRM.

  • Create in CRM links each record if it is found in your CRM, and creates it in the CRM if it is not.

You can run both from the Contacts and Companies pages, through the lemlist API, or by asking lemAgent or your AI assistant through the lemlist MCP.


Limitations

  • Works with HubSpot, Salesforce and Pipedrive. Attio and Zoho work for teams on their beta.

  • CRM Sync only shows in the More menu when your team has a connected CRM.

  • Create in CRM is limited to team admins.

  • On Salesforce, Create in CRM only creates the objects your Salesforce connection grants: Contact, Account or Lead.

  • A contact with no email or LinkedIn URL, or a company with no domain or LinkedIn URL, can't be searched. It is counted as not searchable.

  • Two lemlist companies on the same domain with matching names are ambiguous. Search and connect links neither and shows them as not found. Create in CRM creates neither.

  • Both actions run in the background. Each record shows its CRM status within a few minutes, not right away.

  • Through the API, one call handles up to 10,000 records, and a running search can't be cancelled.


Phase 1: Run the action from Contacts or Companies

  1. Open Contacts or Companies and select the records you want to link.

  2. In the bar at the bottom, click More → CRM Sync.

  3. Click Search and connect to link existing CRM records only, or Create in CRM to also create the missing ones.

Contacts page with two contacts selected and the More menu open on CRM Sync showing Search and connect, Create in CRM as Contact, Create in CRM as Lead and Cancel CRM search

On Salesforce, the create entries follow the object they create. On contacts, the menu shows Create in CRM as Contact and Create in CRM as Lead, depending on the objects your Salesforce connection grants. On companies, Create in CRM shows when the connection grants Account.

To stop a search that is still running, select the same records and click More → CRM Sync → Cancel CRM search.

For a single record, open its side panel: the [CRM] profile row shows Not synced and a Create in CRM link when the record is not linked yet.

✅ Verify: within a few minutes, the selected records show their CRM status.


Phase 2: Follow the results

Each record gets its own result:

  • Found or created: the record is linked to the CRM record.

  • Search running: the CRM status shows the search is in progress.

  • Not found: Search and connect found no matching CRM record. Run Create in CRM if you want it created.

You can launch either action again on the same records at any time.


Use the API

The same actions are available through four endpoints:

  • POST /api/contacts/crm/search-and-connect

  • POST /api/companies/crm/search-and-connect

  • POST /api/contacts/crm/create

  • POST /api/companies/crm/create

Choose the records with one of:

  • idsOrEmails: a list of contact IDs or emails.

  • idsOrDomains: a list of company IDs or domains.

  • listId: a whole list (static, CRM or filter list).

On contacts, asLead: true creates Salesforce Leads.

The answer comes right away and says what was queued, not what happened in the CRM. It counts the records already linked, to search or to create, not searchable, already in progress, and the references that match no record in lemlist.

To follow the result, read the records: the crmSync block of a contact or company shows when a search is running (searching) and when the record was not found in the CRM (notFoundAt). The crmSyncStatus filter accepts searching and not_found. GET /contacts now returns the crmSync block too.

For the full parameters, see the lemlist API documentation at developer.lemlist.com.


Use lemAgent or the lemlist MCP

Two MCP tools run the same actions: crm_search_and_connect and create_in_crm. Ask in plain words, for example "push these 23 leads to HubSpot".

  • The assistant always asks you to confirm with yes or no before it launches the action.

  • It then tells you the work runs in the background and how many records could not be searched.

  • Ask "where is it at?" and it reads the CRM status of the contacts.


Practical example

You imported contacts from a CSV, and most of them already exist in HubSpot. You select them in Contacts and run Search and connect. A few minutes later, most are linked to their HubSpot contact and the rest show as not found. You select the ones not found and run Create in CRM to add them to HubSpot.


Troubleshooting

CRM Sync is not in the More menu

Root cause: Your team has no connected CRM, or the connection isn't finished.

Fix: Go to Settings → Integrations and check that your CRM is connected and set up.

Create in CRM is missing or refused

Root cause: You are not a team admin, or on Salesforce your connection does not grant the object (Contact or Lead on contacts, Account on companies).

Fix: Ask a team admin to run it, or ask your Salesforce admin to grant the object to the connection. Through the API, these cases return 403 CREATE_IN_CRM_NOT_ALLOWED and 400 CRM_OBJECT_NOT_ALLOWED.

Records show as not found

Root cause: No matching record exists in the CRM, or two lemlist companies share the same domain and a matching name, so neither can be matched.

Fix: Run Create in CRM to create the records that don't exist in the CRM. Companies that share a domain and a matching name are skipped by both actions.

Some records were not searched

Root cause: They have no email, domain or LinkedIn URL.

Fix: Add an email or LinkedIn URL to the contacts, or a domain or LinkedIn URL to the companies, then run the action again.

The API returns an error

  • 400 NO_CRM_CONNECTED: your team has no connected CRM.

  • 400 TOO_MANY_RECORDS or TOO_MANY_MATCHES: more than 10,000 records. Split the selection.

  • 400 AS_LEAD_NOT_SUPPORTED: asLead works only on Salesforce contacts.

  • 404 LIST_NOT_FOUND: the listId does not exist.


If your case is different

Did this answer your question?