# Contacts messages | Developer Documentation

<div id="bkmrk-contacts-messagesupd">## Contacts messages

<div><span>Updated: Nov 3, 2025</span></div><div>Contacts messages allow you to send rich contact information directly to WhatsApp users, such as names, phone numbers, physical addresses, and email addresses.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-g7ijru4y.png)</div><div>When a WhatsApp user taps the message's profile arrow, it displays the contact's information in a profile view:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-lju8gmsv.png)</div><div>Each message can include information for up to 257 contacts, although it is recommended to send fewer for usability and negative feedback reasons.</div><div>Please be aware that a contact's metadata (e.g., addresses, birthdays, emails) may not be supported by the recipient, especially on their primary device. Please refer to this [documentation<span>?</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Ffaq.whatsapp.com%2F378279804439436%2F%3Fcms_platform%3Dandroid&h=AT5GDbSFsiJANcSum1aXCIno3-tfWKDeB6SuR4uzmJM19Hm4iolpfLa3906-3U_d_RcJUwiugaV9svOyL6bVTm96A3ZZRP0dFafRbX38_Cd-qVxPOXZilk21mUMOSbkV-N1A-5uBpG8PAbMOCRa-3Q) for the definitions of primary and linked devices.</div><div id="bkmrk-request-parameters"><div id="bkmrk-request-parameters-1"><div>### Request parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example Value </span></th></tr></thead><tbody><tr><td><div><div>`<ACCESS_TOKEN>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>[System token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation) or [business token](/books/meta-whatsapp/page/access-tokens-guide-developer-documentation).</div></div></td><td><div><div>```
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
```

</div></div></td></tr><tr><td><div><div>`<ADDRESS_TYPE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Type of address, such as home or work.</div></div></td><td><div><div>`Home`</div></div></td></tr><tr><td><div><div>`<API_VERSION>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Graph API version.</div></div></td><td><div><div>v25.0</div></div></td></tr><tr><td><div><div>`<BIRTHDAY>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Contact's birthday. Must be in `YYYY-MM-DD` format.</div></div></td><td><div><div>`1999-01-23`</div></div></td></tr><tr><td><div><div>`<CITY>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>City where the contact resides.</div></div></td><td><div><div>`Menlo Park`</div></div></td></tr><tr><td><div><div>`<COMPANY_OR_ORG_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Name of the company where the contact works.</div></div></td><td><div><div>`Lucky Shrub`</div></div></td></tr><tr><td><div><div>`<COUNTRY_CODE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>ISO two-letter country code.</div></div></td><td><div><div>`US`</div></div></td></tr><tr><td><div><div>`<COUNTRY_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Country name.</div></div></td><td><div><div>`United States`</div></div></td></tr><tr><td><div><div>`<DEPARTMENT_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Department within the company.</div></div></td><td><div><div>`Legal`</div></div></td></tr><tr><td><div><div>`<EMAIL_ADDRESS>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Email address of the contact.</div></div></td><td><div><div>`bjohnson@luckyshrub.com`</div></div></td></tr><tr><td><div><div>`<EMAIL_TYPE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Type of email, such as personal or work.</div></div></td><td><div><div>`Work`</div></div></td></tr><tr><td><div><div>`<FIRST_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Contact's first name.</div></div></td><td><div><div>`Barbara`</div></div></td></tr><tr><td><div><div>`<FORMATTED_NAME>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Contact's formatted name. This will appear in the message alongside the profile arrow button.</div></div></td><td><div><div>`Barbara J. Johnson`</div></div></td></tr><tr><td><div><div>`<JOB_TITLE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Contact's job title.</div></div></td><td><div><div>`Lead Counsel`</div></div></td></tr><tr><td><div><div>`<LAST_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Contact's last name.</div></div></td><td><div><div>`Johnson`</div></div></td></tr><tr><td><div><div>`<MIDDLE_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Contact's middle name.</div></div></td><td><div><div>`Joana`</div></div></td></tr><tr><td><div><div>`<PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>WhatsApp user phone number.</div></div></td><td><div><div>`+16505559999`</div></div></td></tr><tr><td><div><div>`<PHONE_NUMBER_TYPE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Type of phone number. For example, cell, mobile, main, iPhone, home, work, etc.</div></div></td><td><div><div>`Home`</div></div></td></tr><tr><td><div><div>`<PREFIX>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Prefix for the contact's name, such as Mr., Ms., Dr., etc.</div></div></td><td><div><div>`Dr.`</div></div></td></tr><tr><td><div><div>`<STATE_CODE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Two-letter state code.</div></div></td><td><div><div>`CA`</div></div></td></tr><tr><td><div><div>`<STREET_NUMBER_AND_NAME>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Street address of the contact.</div></div></td><td><div><div>`1 Lucky Shrub Way`</div></div></td></tr><tr><td><div><div>`<SUFFIX>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Suffix for the contact's name, if applicable.</div></div></td><td><div><div>`Esq.`</div></div></td></tr><tr><td><div><div>`<WEBSITE_TYPE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Type of website. For example, company, work, personal, Facebook Page, Instagram, etc.</div></div></td><td><div><div>`Company`</div></div></td></tr><tr><td><div><div>`<WEBSITE_URL>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Website URL associated with the contact or their company.</div></div></td><td><div><div>`https://www.luckyshrub.com`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_ID>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>WhatsApp user ID. If omitted, the message will display an Invite to WhatsApp button instead of the standard buttons.</div><div>See [Button Behavior](#bkmrk-button-behavior-1) below.</div></div></td><td><div><div>`19175559999`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>WhatsApp user phone number.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr><tr><td><div><div>`<ZIP_CODE>`</div><div>*String*</div></div></td><td><div><div>**Optional.**</div><div>Postal or ZIP code.</div></div></td><td><div><div>`94025`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-button-behavior"><div id="bkmrk-button-behavior-1"><div>### Button behavior

</div></div></div><div>If you include the contact's WhatsApp ID in the message (via the `wa_id` property), the message will include a **Message** and a **Save contact** button:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-eddt0kvo.png)</div><div>If the WhatsApp user taps the **Message** button, it will open a new message with the contact. If the user taps the **Save contact** button, they will be given the option to save the contact as a new contact, or to update an existing contact.</div><div>If you omit the `wa_id` property, both buttons will be replaced with an **Invite to WhatsApp** button:</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-7m30tcjr.png)</div></div>