Contact Messages
How to send a contact card message on the WhatsApp Cloud API, sharing a person's name, phone number, email, and other vCard details.
On this page
A contact message sends one or more contact cards to a recipient. Each card contains a person's name, phone numbers, email addresses, and other vCard fields. The recipient can save the contact directly from the message.
Sending a contact card#
{
"messaging_product": "whatsapp",
"to": "919959623255",
"type": "contacts",
"contacts": [
{
"name": {
"formatted_name": "Rahul Reddy",
"first_name": "Rahul",
"last_name": "Reddy"
},
"phones": [
{
"phone": "+919959623255",
"type": "MOBILE",
"wa_id": "919959623255"
}
],
"emails": [
{
"email": "rahul@example.com",
"type": "WORK"
}
],
"org": {
"company": "Acme Corp",
"department": "Sales"
}
}
]
}Key fields#
| Field | Required | Description |
|---|---|---|
contacts | yes | Array of contact objects (can send multiple at once) |
name.formatted_name | yes | Full display name |
phones | no | Array of phone objects with phone, type, wa_id |
emails | no | Array of email objects with email and type |
org | no | Company and department |
Only name.formatted_name is required. All other fields are optional.
Reference images#
Frequently asked#
How do I send a contact card on WhatsApp API?
Set type to "contacts" and provide an array of contact objects. Each contact needs at
minimum name.formatted_name. Add phones and emails as needed.
Can I send multiple contacts at once?
Yes. The contacts field is an array — add multiple objects to send several contact cards
in one message.
What phone type values are accepted?
CELL, MAIN, IPHONE, HOME, WORK. Use MOBILE for a standard mobile number.
Gotchas & common mistakes#
Was this page helpful?
Still stuck? Open a support ticket and our team will help.