Built on the official Meta WhatsApp Business API Official Meta WhatsApp Business API See plans

Add and import contacts

5 min read Updated 19 Nov 2026

This guide shows you how to add contacts one by one, import many contacts from an Excel file, and manage them afterwards. You need a connected WhatsApp number and an active plan first.

Important

Only message people who have agreed to hear from you on WhatsApp. This is called an opt-in. Meta can lower your quality rating or limit your number if many people report or block your messages. See Opt-in, opt-out and the STOP keyword.

Before you start#

Every contact needs a phone number written with the country code and no zero in front. For an Indian number, write 919876543210 or +919876543210. In the Add New form, type digits only (with an optional plus sign at the start), without spaces or dashes. The number must be 10 to 15 characters long. In an import, the platform removes spaces and symbols for you.

  • Your plan has a contact limit. When you reach it, new contacts are refused with the message "Insufficient Contacts Limit".
  • You must have an active subscription. Without one you see "No active subscription".
  • Each phone number can exist only once in your account.

Open Contacts

Add one contact#

  1. Open the Contacts screenIn the left menu click WhatsApp, then Contacts. You see the Contacts Management table.
  2. Click Add NewThe button is at the top right. The Add New Contact form opens.
  3. Fill in the detailsName and Phone (with country phone code) are required. Optional fields are Contact Lists, Segments, Country and a contact photo. If you created custom fields, they also appear at the bottom of the form.
  4. Click SubmitYou return to the contacts table and the new contact is in the list. If the number already exists, you see "The phone number has already been taken" under the phone field.
yourdomain.com/client/contacts
Dashboard
WhatsApp
Campaigns
Contacts Management Add New1 Import2
#NamePhoneContacts ListSegmentsStatusAction
1Aarav Sharma+91 98xxx xxxxxUncategorizedDefaultActive 3
The Contacts screen. Add a single contact or open the import screen from the buttons at the top.
  1. Add New opens the Add New Contact form
  2. Import opens the Excel import screen
  3. Ban icon blacklists a contact

If you do not choose a list, the contact is placed in a list called Uncategorized and in a segment called Default. You can change this later. To learn about lists and segments, read Contact lists, segments, tags and custom fields.

Import many contacts from Excel#

Use the import screen when you have more than a few contacts. It accepts only .xlsx files up to 10 MB. CSV files are not accepted here.

  1. Open the import screenOn the Contacts screen click Import at the top right. The Import screen opens with an empty table.
  2. Download the sample fileClick "Download sample file here" or the Sample Download button. Open it in Excel or Google Sheets and keep its structure.
  3. Fill your contactsColumn 1 is the name and column 2 is the phone number with country code. Keep the first row as the heading, because the platform skips it. Save the file as .xlsx.
  4. Choose the fileClick the Choose File box and pick your file. The names and phone numbers appear in the table on the screen. Check them. You can also edit any cell.
  5. Pick lists and segments (optional)In the table, the Contact Lists and Segments columns have drop-downs. You can choose one or more for each row. If you leave them empty, the contact goes to the Uncategorized list and the Default segment.
  6. Click Confirm UploadA green message "Created Successfully" appears and the table is cleared. Open the Contacts screen to check the new contacts.
yourdomain.com/client/contact/import
Dashboard
WhatsApp
Campaigns
Import Sample Download
Choose Filecontacts.xlsx1
NamePhone (with country phone code)Contact ListsSegments
Aarav Sharma919812300000Diwali sale2Gold customers
Confirm Upload3Reset Table
The Import screen. Pick your .xlsx file, check the rows, choose lists and segments, then confirm.
  1. Choose File: your .xlsx file
  2. Optional list and segment drop-downs for each row
  3. Confirm Upload saves the contacts
Note

The phone number is required in every row. A row without a phone turns red and the message "Required Field/Fields are Missing" appears. If a number already exists in your account, it is not duplicated. The existing contact is only added to the lists and segments you chose.

Manage your contacts#

On the Contacts screen, the filter button (funnel icon) opens filters for contact list, segment, country, status and blacklist. Click Filter to apply and Reset to clear them. The Export button downloads the contacts that match your filters as an Excel file.

  • Edit: click the pencil icon in the Action column to change name, phone, lists, segments or country.
  • Blacklist: the ban icon blocks a contact. Blacklisted contacts are skipped in campaigns. Use the check icon to remove the block.
  • Delete: the bin icon deletes one contact.
  • Bulk Action: tick the boxes in the first column, then use Bulk Action to Add List, Remove List, Add Segment, Remove Segment, Add Blacklist, Remove Blacklist or Delete Contacts for all selected contacts together.

Only contacts that are active and not blacklisted receive campaigns. Read Send your first campaign to use your contacts.

Common problems#

"The phone number has already been taken"

This contact already exists in your account, with or without a plus sign. Search for the number in the contacts table and edit that contact instead.

"The uploaded file must be an Excelfile" or file too large

Save your sheet as .xlsx, not .csv or .xls, and keep it under 10 MB. For a very large list, split it into two or more files.

"Insufficient Contacts Limit"

Your plan allows a fixed number of contacts. Delete contacts you no longer need, or upgrade your plan from your billing page.

Numbers look wrong after import

Write numbers as text with the country code, for example 919876543210. A number without the country code may be saved wrongly or fail when you send a campaign.

Need help?#

If you are stuck, contact support on WhatsApp +91 99159 60958 or email info@whatsappmarketingagency.com, or use the contact page.

Was this guide helpful?
Black Friday Sale – Get 20% OFF!
Latest offer

Black Friday Sale – Get 20% OFF!

Unlock smarter business communication this Black Friday! Enjoy 20% OFF on all WhatsApp Marketing Agency plans, including WhatsApp Business API, bulk messaging, AI chatbots, CRM integration and automation. Use coupon code BLACKFRIDAY20 at checkout. Limited-time offer: 27–30 November 2026.

Claim 20% OFF Now