Upload your contacts via API

Help Docs RumbleUp Academy Contacts Upload Contacts via API

As an alternative to the Basic Contact Import in the portal, you can use RumbleUp’s programmatic API to import your contacts. The import is done via HTTP POST request method. Each import request will create a separate segment.

The file must be in CSV format, with the first line as a header row with column names

Required column names:
phone, name or first_name

Allowed column names:
phone, name, first_name, last_name, email, street, city, zipcode, url, icon, source, descr, custom1, custom2, custom3, custom4, custom5

Recommended POST request method for Mac users:

  1. Retrieve your API key. Go to Tools > Integrations, API Keys > click Add Key

  2. Use

curl -X POST -u CID:APIKEY -F 'csv=@file.csv' https://app.rumbleup.com/api/contact/import

to post the request.

Note: if you use the shortcut to copy your API key, you must replace the default / with a : in your POST request.

Recommended POST request method for Windows users:

  1. Retrieve your API key. Go to Tools > Integrations, API Keys > click Add Key

  2. Use

curl -X POST -u CID:APIKEY -F csv=@file.csv https://app.rumbleup.com/api/contact/import

to post the request.

Note: if you use the shortcut to copy your API key, you must replace the default / with a : in your POST request.

Common Errors

ALERT: If an error occurs during this process an email will be sent with reason for failed upload.

Enter host password for user

Check the argument entered for -u option. The CID:API key must be separated by a colon ( : ) not a forward slash ( / ).

Warning: Illegally formatted input field!

Check the argument for -F option. You must specify the file type (csv=@file.csv).

No required columns provided: phone and (name or first_name)
  1. Check the CSV file. Do you have a header row with the required fields?
  2. Check the data submission argument. It should be -F where Content-Type is multipart/form-data or –data-binary
  3. Make sure that each column is lower case otherwise the API will not use them.