> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wazzapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts

> Manage contacts, groups, imports, exports, and sync workflows

# 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.

<Steps>
  <Step title="Navigate to Contacts">
    Go to the **Contacts** tab in the sidebar.
  </Step>

  <Step title="Add Contact">
    Click **Add Contact** to add one record at a time, or use CSV import for larger lists.
  </Step>

  <Step title="Fill Details">
    Enter a phone number and any optional details such as name, email, tags, or custom fields.
  </Step>
</Steps>

### Creating Groups

1. Go to **Contacts > Groups**.
2. Click **Create Group**.
3. Name your group (e.g., "VIP Customers").
4. 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.

```bash theme={null}
# 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](/api-reference).