{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Upload a CSV of contacts to your sequences","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"upload-a-csv-of-contacts-to-your-sequences","__idx":0},"children":["Upload a CSV of contacts to your sequences"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CSV Upload lets you add contacts from your own tables — CRM exports, event sign-ups, webinar attendees — directly to a Lusha Engage sequence. No Lusha credits are consumed when uploading a CSV."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"csv-file-requirements","__idx":1},"children":["CSV file requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each contact must include at minimum: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["First Name"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last Name"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email Address"]},". Including additional fields like Company and Industry is recommended — they can be used as personalisation variables in your emails."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["File limits: CSV format only, up to 20 MB, maximum 10,000 rows, maximum 50 columns, at least 2 columns of data per contact. Each sequence can hold up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["500 contacts"]}," — split larger tables across multiple sequences if needed."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Tip: Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/csv-enrichment/csv-enrichment"},"children":["Lusha's CSV Enrichment"]}," to fill in missing data points before uploading, so your contacts are fully profiled when outreach begins."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-upload-a-csv-to-a-new-sequence","__idx":2},"children":["How to upload a CSV to a new sequence"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When creating a new sequence, go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Contacts"]}," step and select the CSV upload option."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571791/f724c6aa3fba8b04ce6a211972de/AD_4nXcqRqEStbRip8ikQVB0b0hzpsmXzoZfobk1sGRgqwy3x7qV24vLZ09LeY8PqUmaDuKvzYwWyDaj2QOJVnfl2WmkIQlOXTqhxv8l1ZAnGH4g9EN9Mc2ylhYXxfVhi5N3jZtxEbX6?expires=1780056000&signature=f21df307bd33558965fa940c47e479cfb1f86eb345f63aae7685779a03993c91&req=0tBqwln9pTZk2hj99dpg6pNkMvJ6DUXe5RXjnxJKHdBJLH9mbhaoyrmJuQXM%0AOmIsKMQnknDFpX5QVHQMdSYo%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drag and drop your CSV or use the file upload button. Make sure the file meets the requirements above."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571793/f8b2605eae19cf086c02f9cc32ab/AD_4nXfFRAXpu1U_ffsHRWbVSnrxDtGLfyk_NlWdg49K9XGXd7kHJIQVr3qWxJ8BidR5Xo-g2JacEeN2ttOb4njfIqbfVnNpvmlF_4uHYHH9IdRjD53x5JQQ6fzAl35z0JolmiN-DEFPcA?expires=1780056000&signature=a1162dbf489285070021c9fa0fc3771c9f831688de5ba26426c2db3974e0323e&req=0tBqwln9pTRk2hj99dpg6htLaXcH0KQuE4Ny9yeWknfkEcxI5T4btRv0u0wx%0A%2BhJHBtwK5rKDYNJoIbcr4sK1%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Map your CSV columns to the corresponding Lusha fields (e.g., your \"First Name\" column → Lusha's First Name field). Mapped fields become available as personalisation variables in your emails."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571789/5ada6efb53fbdfaaf864aad5aea0/AD_4nXdiRVfDgqV7lZcpakm_GIvYb-84RjruFDutbIUTc1Ot0eIgkJPoEyryj-OVgChmQRKJJ5pYdhLpp9es4JC8WtR2X62VnhqUwt12EeitrgbNI94aXfez4pADwxELdVDXhnMSfiVT?expires=1780056000&signature=0d566558b3d8bbc41a31ef5342c37b3fab2e6a13df1de62dc84645164aa8912b&req=0tBqwln9pD5k2hj99dpg6lrYN8VohIF0Z6p6i2HSmyT7Bc9P9cytTsJAF5Bk%0AseRFi5nwFrGmZq1zgTi7bdRv%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the contacts you want to add and click to upload."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571788/5f52d83592f82cd075466e20395d/AD_4nXcz-miP8fb90JYFdoJbwaTsNmkRf0JqDW01B-akh2s4TJC5IbzVilt_DwbqLSZoWg4b-U_6BsIXxjsZxFG5JzgKkSi5zexWgebbWSWEIWXJp0smYCmsqbGwVJL5ZSl73L3sjG0SMQ?expires=1780056000&signature=843e6a6519b7b4161d6ad9ce3cb28d8926087a7fcb876e235a4c419aa51d5f10&req=0tBqwln9pD9k2hj99dpg6tWNihdmtzdzpH5xM8wgEvoyCFILjXGQnHshdpbE%0As3R4b%2BVChshMekbIpr7ObufR%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571792/aa6a86b9ef870bcc6fef2c548479/AD_4nXcFw_DBir53tz6XKQjHFxiXqu_5HL2FypZhtbvbyQDAYKqy_vhtBqOhKU0t3EqwfFHoj1IReok3IyQ6ntvo8fYKrwLNxmNzYTR-pYcGiPRV4nBomXRnz3BBNos-eEMFQE0ii81YNQ?expires=1780056000&signature=871d5f7f38e2693d8c9a69418d857e90b72bd51bca09829f4798ea3161ec18ff&req=0tBqwln9pTVk2hj99dpg6siM34dJ1WDByCLobLy91CMClfaRT7Uf6EmYEKlW%0AK8s6%2B1v4Eudo8kOpSOpm%2FgCP%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your contacts are now added to the sequence."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-upload-a-csv-to-an-existing-sequence","__idx":3},"children":["How to upload a CSV to an existing sequence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open the sequence from Engage's main screen and go to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]}," tab."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the sequence has no contacts yet, choose the CSV upload option and follow the steps above."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the sequence already has contacts, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Contacts"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import from CSV"]}," and follow the same steps."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571790/30f634f02ef0c258a0e264ac46da/AD_4nXe7i1JmcWarArPbncVyZOXAuyrEGv9OHMzvpmAHYxLXxuFpXE1PJA24Qa56yKdlbPMxPexC4ypZfZnXVlgmOnS_KLwr0GlvHvcIZ8c9b4miC2vjyMf9eR8EQj-4gKsghsn7rnltpQ?expires=1780056000&signature=18bf1a12567d2268ca3466df063db20d412de2c540e76a963a399519ed7ae95e&req=0tBqwln9pTdk2hj99dpg6j0Y04WU6MPEJBzf57CDimQUHFIFHZJeqVs8bjPV%0A4Yeyz6G7aqq2O%2BhotBepOSS9%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/25571794/18cd098c900f41580945e2ef40dc/AD_4nXe1DKlI_0Biu00A3H4Gs9NRK_26ZtZ471qTQlD38wp2v0-trMAUvwyKISDUBXvkiuiNp97qzajn6kKCLLR-cJzlzd5LfnRGeeOW8R6M-2fK6O6-QUw8avcvJAAWrb7kwZtiIeW1LA?expires=1780056000&signature=0bd5dfc322f834ecba1389c4612526fdab69416310fd30fb609f1c088c27d3a5&req=0tBqwln9pTNk2hj99dpg6rPpxpnucq1dggGApHTGWuU8H3itCU5kLnrWbia3%0AoJivUPSsRFE9FnRIN7XdiZ%2BA%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Each sequence is limited to 500 contacts. Divide larger tables across multiple sequences if needed."]}]}]},"headings":[{"value":"Upload a CSV of contacts to your sequences","id":"upload-a-csv-of-contacts-to-your-sequences","depth":1},{"value":"CSV file requirements","id":"csv-file-requirements","depth":2},{"value":"How to upload a CSV to a new sequence","id":"how-to-upload-a-csv-to-a-new-sequence","depth":2},{"value":"How to upload a CSV to an existing sequence","id":"how-to-upload-a-csv-to-an-existing-sequence","depth":2}],"frontmatter":{"title":"Upload a CSV of contacts to your sequences","description":"How to upload a CSV of contacts to a Lusha Engage sequence, including file requirements and column mapping.","seo":{"title":"Upload a CSV of contacts to your sequences"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/add-contacts/upload-a-csv-of-contacts-to-your-sequences","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}