Contacts

Contacts are optional — you can send to raw numbers — but storing them lets you send to a group instead of assembling a list on every request.

Endpoints

Method	Path	Purpose
`GET`	`/contacts`	List your contacts
`POST`	`/contacts`	Create one
`PUT`	`/contacts/{contactId}`	Update one
`DELETE`	`/contacts/{contactId}`	Delete one
`POST`	`/contacts/upload`	Bulk upload
`DELETE`	`/contacts/bulk`	Delete several at once

Create a contact

string

required

International format, e.g. 255766298542.

string

curl -X POST https://api.huduma.cloud/contacts \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "255766298542",
    "firstName": "Asha",
    "lastName": "Mushi"
  }'

Groups

Group membership is managed separately:

Method	Path	Purpose
`POST`	`/group-contacts`	Add contacts to a group
`GET`	`/group-contacts/{groupId}`	List a group’s contacts
`DELETE`	`/group-contacts`	Remove contacts from a group

You are responsible for having a lawful basis to message everyone on your lists, and for honouring opt-out requests. Uploading a purchased or scraped list breaches the acceptable use rules and can get your account suspended.

Getting started

API reference

Guides

Endpoints

Create a contact

Groups

​Endpoints

​Create a contact

​Groups

Endpoints

Create a contact

Groups