Herbby API

Contacts API

The Contacts API allows you to programmatically manage the audience in your workspace. You can sync contacts from your external CRM, add tags, and organize them into groups for targeted campaigns.

List Contacts

Retrieve a paginated list of all contacts in your workspace.

GET/api/v1/contacts
curl -X GET https://api.herbby.digitechedge.com/api/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Create a Contact

Add a new contact to your workspace. The phone number must include the country code.

POST/api/v1/contacts

Request Body

FieldTypeDescription
name *stringThe full name of the contact.
phone *stringThe phone number in international format (e.g., +233...).
emailstringOptional email address.
tagsarrayAn array of tag strings to attach to the contact.
curl -X POST https://api.herbby.digitechedge.com/api/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "John Doe",
    "phone": "+233505160686",
    "email": "john@example.com",
    "tags": ["vip", "customer"]
  }'