The UserLeap Developer Hub

Welcome to the UserLeap developer hub. You'll find comprehensive guides and documentation to help you start working with UserLeap as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Guides

Importing a CSV File


We accept a simple standard format with many optional extras

<any string><valid email><any string><any>

From the above example, one of user_id and email are required properties as we need a unique identifier to prevent duplication, list_name is recommended, but not required and will be set as a Custom Visitor Attribute for any visitor created with that column. The last column demonstrates setting additional Visitor Attributes with a column name, plus some value, (rows with no value for the given column will not have an Attribute created in our system). All user id values are treated as strings by our system and should be uniquely identifiable by your systems.



If a row in your CSV does not have one of user_id or email that row will be rejected and no visitor will be created.

# example.csv

1,[email protected],First Upload,cheeseburgers
2,[email protected],First Upload,poptarts
3,,First Upload,pizza



In the above example, one user doesn't have an email input, this is ok so long as there's a user_id value, you just won't be able to send them email-based surveys.

The maximum row count for CSV uploads is 65000, if you need to upload more than that, please reach out for assistance.

Uploading with the API

Make sure you have your UserLeap API key handy, as it's required. You can find that on the Connect Page.

curl --location --request POST '' \
-H 'Content-Type: text/csv' \
-H 'Authorization: Bearer <YOUR_API_KEY>' \
--data-binary '<PATH_TO_CSV>'

Uploading through the Dashboard

The formatting for the CSV is the same and the upload can be done through the Dashboard UI. You can find the CSV upload option under Connect, Upload a Spreadsheet.

Updated about a month ago

Importing a CSV File

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.