Contact Management

Use contacts to keep your audience organized and make messaging workflows easier to manage at scale.

What you can do

create contacts manually
organize contacts into groups
import and export CSV data
track opt-out status
sync contacts from connected WhatsApp accounts
fetch WhatsApp profile picture metadata and image for a contact

Dashboard Guide

You can manage contacts directly from the WazzAPI dashboard.

Navigate to Contacts

Go to the Contacts tab in the sidebar.

Add Contact

Click Add Contact to add one record at a time, or use CSV import for larger lists.

Fill Details

Enter a phone number and any optional details such as name, email, tags, or custom fields.

Creating Groups

Go to Contacts > Groups.
Click Create Group.
Name your group (e.g., “VIP Customers”).
Select contacts from the list to add them to the group.

API coverage

The public API includes endpoints for:

contact CRUD
group CRUD
add/remove group members
CSV import/export
contact sync initiation and status lookup
contact profile picture metadata and image retrieval

Profile pictures

Resolve a contact’s WhatsApp profile picture after you have their contact ID.

# Metadata (URL + picture ids)
curl -X GET "https://api.wazzapi.com/api/v1/contacts/{contact_id}/profile-picture" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Image bytes (may 302-redirect to the stored image URL)
curl -L -X GET "https://api.wazzapi.com/api/v1/contacts/{contact_id}/profile-picture/image" \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoint	Response
`GET /api/v1/contacts/{contact_id}/profile-picture`	JSON metadata (`ContactProfilePictureResponse`) including `url`, `picture_id`, and `preview`
`GET /api/v1/contacts/{contact_id}/profile-picture/image`	Image payload, or a `302` redirect to the picture URL

Full request/response schemas are in the API Reference.

Shared Inbox WhatsApp Groups

​Contact Management

​What you can do

​Dashboard Guide

​Creating Groups

​API coverage

​Profile pictures