We accept a simple standard format with many optional extras
|<any string>||<valid email>||<any string>||<any>|
From the above example, one of
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
# example.csv user_id,email,list_name,food_preference 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_idvalue, 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.
Make sure you have your UserLeap API key handy, as it's required. You can find that on the Connect Page.
POST - https://api.userleap.com/v1/users/bulk
curl --location --request POST 'https://api.userleap.com/v1/users/bulk' \ -H 'Content-Type: text/csv' \ -H 'Authorization: Bearer <YOUR_API_KEY>' \ --data-binary '<PATH_TO_CSV>'
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