Skip to main content

List Campaign CSV Upload Guide

How to Upload and Format a CSV File for List Campaigns

List campaigns allow you to send connection notes and direct messages to LinkedIn profiles using a structured CSV file.

To set up a campaign, you need to upload a CSV file containing a list of LinkedIn profile URLs. The file can also include additional data, which can be used as variables in your campaign messages.

Formatting Your CSV File

Your CSV file can contain any number of columns, but it must meet the following requirements:

  • Column names: All columns that contain data must have a header name

  • LinkedIn URL: At least one column must contain LinkedIn profile URLs (starting from the first row of data)

  • Row limit: Maximum of 10,000 rows

  • File size: Maximum of 50MB

Any additional columns that do not contain LinkedIn URLs can be used as custom variables in your campaign messaging.

Example CSV Structure

A typical CSV file may look like this:

linkedin_url

connection_note

followup_message

https://linkedin.com/in/johndoe

Hi John, let’s connect!

Looking forward to speaking with you.

https://linkedin.com/in/janedoe

Hello Jane, just checked out your profile, would love to connect!

Let’s schedule a time to chat.

Column breakdown:

  • linkedin_url
    Contains LinkedIn profile URLs for your campaign targets.
    This column must be selected as the unique identifier.

  • connection_note
    A personalized message sent with the connection request.

  • followup_message
    A message sent after the connection request is accepted.

Uploading Your CSV File

  1. Navigate to the List Campaigns section

  2. Click Upload CSV and select your file

  3. Choose the Identifier Column (the column containing LinkedIn profile URLs)

  4. Allow the system to process (parse) your CSV file

    Note: Missing data in some rows is allowed. However, messages that rely on missing variables will be skipped.

  5. Once uploaded, you can use your CSV data as custom variable placeholders in your campaign messages

  6. Review the imported data and start your campaign

CSV Upload Error Handling

Invalid file format

If your CSV file does not meet the required criteria (e.g. missing LinkedIn URLs, missing column names, or exceeding size/row limits), the upload will fail.

In this case, update your file and upload it again.

Missing data in rows

Some rows may contain missing values (e.g. empty cells or unused columns). This is not a critical issue - the file can still be used.

However, there are important limitations:

Handling Missing Data for Variables

Messages that contain variables with missing values will not be sent.

This applies to all variable types, including:

  • System variables

  • AI-generated variables

  • Custom CSV variables

If a message includes a variable that has no data for a specific row, the entire message for that contact will be skipped.

Did this answer your question?