Contact Lists

A contact list is a named group of recipients you send broadcasts and bulk emails to. Each list is an independent audience within your institution workspace, holding its own contacts.

A contact stores an email address, an optional name, and an optional set of metadata (arbitrary key/value pairs). Metadata can be used as template variables when sending. See Sending to contact lists.

Create a list

1. Go to Audiences in the sidebar.
2. Click New audience.
3. Enter a name for the list, for example "Public notices", "County suppliers", "Health facility contacts", or "Stakeholders". You can also add an optional description.
4. Click Create audience.

Add contacts manually

1. Open a list from the Audiences page.
2. Click Add contact.
3. Enter the contact's email address (required).
4. Optionally add a name.
5. Click Add contact to save.

The manual form captures only an email and an optional name. To attach metadata (custom fields), import a CSV instead.

Each email address can appear only once per list. Adding an address that already exists in the list is rejected as a duplicate.

View contacts

Open any list to see the contacts in it. Contacts are listed newest first and paginated.

Delete contacts and lists

• To remove a contact, open the list, find the contact, and click Remove. Confirm in the dialog.
• Deleting an entire list is available through the API (DELETE /v1/contacts/{list_id}), which removes the list and all contacts in it. The dashboard does not yet expose a delete-list action.