Skip to main content

​
Overview

Contacts are the people you send messages to. Groups help you organize contacts for targeted campaigns.

​
Managing Contacts

​
Creating Contacts

Add contacts individually via the API: 
{
  "phone_number": "233241234567",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com"
}

​
Contact Fields

FieldRequiredDescription
phone_numberYesInternational, local, or with + prefix
first_nameNoUsed for personalization
last_nameNoUsed for personalization
emailNoContact’s email address

​
Working with Groups

Groups allow you to organize contacts for targeted messaging.

​
Creating a Group

{
  "name": "VIP Customers",
  "description": "High-value customers for premium campaigns"
}

​
Assigning Contacts to Groups

You can assign multiple contacts to multiple groups in one request: 
{
  "contact_ids": ["1", "2", "3"],
  "group_ids": [
    "ee9fb0b4-83f0-4be5-a0be-1063e05ff0b8",
    "feab58b8-df74-435e-ae09-d7dde096ff0c"
  ]
}

​
Use Cases

Create groups for different customer segments:
  • New customers
  • VIP customers
  • Inactive customers
  • Newsletter subscribers
Organize contacts by location:
  • Accra customers
  • Tamale customers
  • Regional offices
Group customers by product interest:
  • Product A users
  • Product B users
  • Beta testers

​
Best Practices

Keep groups updated: Regularly review and update your groups to ensure accurate targeting.
Respect privacy: Only add contacts who have consented to receive messages from you.

​
API Reference

Contacts API

Manage contacts programmatically

Groups API

Create and manage contact groups