Contacts, Custom Fields, Groups & Consent
Manage your contact list, organize contacts into groups, track custom details, and keep an audit trail of who's opted in or out.
Last updated 2026-08-14
Every person who has ever messaged your WhatsApp number — or that you've added manually — is a contact. Beyond the basics (name, phone number), you can track custom information about each one, organize them into groups for targeted campaigns, and WhatsApp Cloud keeps an automatic record of who has opted in or out of marketing messages.
Contact list
See every contact on your account in one place, with filters to narrow it down.
- Go to Contacts from the left menu.
- Use the filters to narrow by group, subscribed status, or assigned teammate.
Add a contact manually
Add someone to your contact list even before they've messaged you.
- Go to Contacts from the left menu.
- Click "New contact".
- Enter their name and phone number, and save.
Custom fields
Define your own fields to track information a standard contact record doesn't cover — for example, a customer ID, membership tier, or preferred language.
- Go to Custom Fields from the left menu.
- Create a field with a name and a type (text, number, date, or email).
- Open any contact's conversation in the Inbox, expand "Contact details", and fill in the field's value for that contact.
Contact groups
Organize contacts into named groups so you can target a specific audience with a broadcast campaign.
- Go to Groups from the left menu.
- Create a group with a name.
- Open any contact's conversation in the Inbox, expand "Contact details", and check the groups that contact belongs to.
Subscribe / unsubscribe status
Every contact has a subscribed status controlling whether they can receive broadcast campaigns. This is separate from being able to reply to them individually in the inbox.
- Open the contact's conversation in the Inbox and expand "Contact details".
- Toggle "Subscribed to campaigns" on or off.
Automatic opt-out (STOP keyword)
If a customer texts "stop", "unsubscribe", or "optout" (case-insensitive), they're automatically marked unsubscribed — no manual action needed.
Consent audit trail
Every subscribe/unsubscribe event — whether triggered by the STOP keyword, a manual toggle, or a CSV import — is permanently recorded, so you have a compliance record of when and how a contact's consent status changed.
Export contacts to CSV
Download your contact list as a CSV file, including any custom fields you've set up.
- Go to Contacts from the left menu.
- Optionally apply filters (group, subscribed status, assigned teammate) to export just that subset.
- Click "Export CSV".
Import contacts from CSV
Add or update many contacts at once by uploading a CSV file, matching its columns to contact fields yourself so it works with exports from other tools.
- Go to Contacts from the left menu and click "Import CSV".
- Upload a CSV file with a header row.
- Match each column to a field — Name, Phone number, Subscribed, Group(s), an existing custom field, or "Create new custom field".
- Click "Start import".
Frequently Asked Questions
What's the difference between subscribing a contact and just messaging them?
Subscribed status only controls whether a contact receives broadcast campaigns. You can always message an unsubscribed contact individually from the inbox — that's treated as a normal conversation, not marketing.
Can I import contacts from a CSV file?
Yes — go to Contacts and click "Import CSV". You'll match your file's columns to contact fields before confirming, so it works even if your column names don't match ours exactly.
What happens to rows my CSV import couldn't process?
They're skipped, not treated as a fatal error for the whole file — the rest of the file still imports. The results page lists exactly which rows were skipped and why (most commonly a missing or invalid phone number).
Can I bulk-add contacts to a group or unsubscribe several at once?
Not yet — group membership and subscribe/unsubscribe status are currently set one contact at a time from that contact's conversation. Bulk actions are on the roadmap.
What happens if someone texts STOP by accident?
They're marked unsubscribed immediately. You can manually re-subscribe them from their contact details in the inbox if they confirm they want to opt back in.
Ready to Get Started?
See it for yourself
Create a free account and connect your WhatsApp Business number in minutes.
Get Started