Contacts

Manage contacts, organize them into groups, and send SMS to entire groups at once.

Overview

Contacts let you store phone numbers with names so you can quickly select recipients when sending messages. Organize contacts into groups for bulk messaging — send to an entire group with a single action.

Contacts are also used to auto-fill template variables like {{name}} when sending personalized messages.

Managing contacts

Adding contacts

  1. Navigate to Contacts in the sidebar
  2. Click Add Contact
  3. Enter a name and phone number
  4. Optionally assign the contact to one or more groups
  5. Click Create

Importing contacts

You can bulk-import contacts from vCard (.vcf) files. This is useful for importing contacts exported from your phone, Google Contacts, or other services.

  1. Go to Contacts
  2. Click Import
  3. Select a .vcf file
  4. Review the preview and confirm

Duplicate phone numbers are skipped during import.

Groups

Groups let you organize contacts and send messages to multiple recipients at once. A contact can belong to multiple groups.

Creating groups

  1. Navigate to Contacts and switch to the Groups tab
  2. Click Add Group
  3. Enter a group name

Sending to groups

When composing a message in the dashboard, you can select one or more groups as recipients. All contacts in those groups will receive the message.

Via the API, pass group_ids instead of (or in addition to) recipients: 

POST /api/sms/send
{
  "group_ids": ["group_id_1", "group_id_2"],
  "body": "Hello everyone!"
}

API access

Contacts and groups are stored in the contacts and contact_groups collections. All operations are scoped to the authenticated user.

List contacts

GET /api/collections/contacts/records

Create a contact

POST /api/collections/contacts/records
Field Type Required Description
name string Yes Contact name
phone string Yes Phone number in E.164 format
groups relation[] No Array of group IDs

List groups

GET /api/collections/contact_groups/records

Export contacts

GET /api/contacts/export

Returns all contacts as a downloadable vCard (.vcf) file.

Related