Skip to main content

List Campaign CSV upload guide

How to Upload and Format a CSV File for Aimfox List Campaigns

Bozidar Nikolic avatar
Written by Bozidar Nikolic
Updated over 2 weeks ago

List campaigns in Aimfox allow you to send connection notes and direct messages to LinkedIn profiles. To set up a campaign, you need to upload a CSV file with a list of target profile URLs. The file can also contain other data, which can be used as variables in your campaign messaging.

Formatting Your CSV File

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

  1. Column names: All columns with any data must have a name.

  2. LinkedIn URL: At least one column must have a LinkedIn URL in the first row.

  3. Row count: The file can have a maximum of 10.000 rows

  4. File size: The maximum allowed file size is 50MB

Any "Extra" columns not containing a LinkedIn URL will be available for use as custom variables in the campaign.

Example CSV Structure

A typical CSV file might include a list of LinkedIn accounts you want to reach out with a custom connection note and follow-up message you prepared for every target. It could look something like this:

linkedin_url

connection_note

followup_message

Hi John, let’s connect!

Looking forward to speaking with you.

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

Let’s schedule a time to chat.

  • linkedin_url: This column contains LinkedIn profile URLs for your campaign targets, and must be selected as the unique identifier.

  • connection_note: A personalized message to be sent with the connection request.

  • followup_message: A follow-up message to be sent after the connection request is accepted.

Uploading Your CSV File

  1. Navigate to the List Campaigns section in Aimfox.

  2. Click on Upload CSV and select your file.

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

  4. Let the system parse your CSV file. NOTE: It's okay to have missing data in some rows, just be aware that messages trying to send a variable that's missing data will be skipped.

  5. Once uploaded, you can insert data from your CSV into campaign messages as custom variable placeholders.

  6. Review the imported data and start your campaign.

CSV upload error handling

If the CSV file is incorrectly formatted (without LinkedIn URLs, column names, or it exceeds file size and row limits), the upload will fail. In this case you will have to format it correctly and try again.

Another possible case is that some rows in the uploaded CSV have missing data. This can happen if certain fields are empty, or if you leave a few extra column names in the file. This is not a critical issue and the file can still be used in your campaign, but it does have certain restrictions, outlined below.

Handling missing data for custom variables:

Aimfox does not send out messages with missing variables. This is true for all variables, both system defaults, AI variables, or custom variables.


For this reason, trying to send a message containing a custom variable with missing data will fail and the entire message will not be sent out.

Did this answer your question?