Home

For Developers

Help Docs Developer Resources Contact API Auto-Import

Import your contacts automatically from a known location

Help Docs Developer Resources Contact API Auto Import Setup

As an alternative to the Basic Contact Import in the portal or import via API, you can use ask our support to establish automatic import of your contacts from a known location. The import will be done at regular intervals you specify. Each import can create a separate segment or append to an existing 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

What we need to setup auto import

Please send the details to our support person

  • Provide us with the location URL to your SFTP or HTTPS site. The url must be in the format: https://host/file or sftp://host/file
  • It is recommended to use username and password to keep file from public access
  • The location url may contain time placeholders: %Y - year, %m - month, %d - day, %H - hour, %M -minutes, %S - seconds, %u - Unix epoch in seconds, for example: https://domain.com/file-%Y%m%d%H%M.csv
  • If you want a file added to an existing contact segment, provide the segment ID (found in the portal).
  • Tell us how often we import the specified file