Skip to main content
Contacts are shared by SMS, WhatsApp, email and the CRM. Group them two ways:
  • Lists: a contact belongs to a list, for example Customers or Event leads.
  • Tags: lower-case labels such as vip or city. A contact can carry many.
Campaigns can target lists, tags or both.

Add a contact

string
Phone number. A contact needs a phone or a name.
string
Full name. You can send firstName and lastName instead.
string
Email address.
string
The contact list to add them to.
string
marketing (default), non-marketing or unsubscribed.
string[]
Lower-case labels.

Lists

Syncing a large customer base? Page through GET /contacts with listId and add only the contacts that aren’t there yet. For a one-off import of thousands, the CSV import in the dashboard is quicker.