> ## Documentation Index > Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt > Use this file to discover all available pages before exploring further. # Contacts messages # Contacts messages Updated: Nov 3, 2025 Contacts messages allow you to send rich contact information directly to WhatsApp users, such as names, phone numbers, physical addresses, and email addresses. ![](https://scontent-fra3-2.xx.fbcdn.net/v/t39.2365-6/441381765_2668119610015051_1596469393832242771_n.png?_nc_cat=104\&ccb=1-7&_nc_sid=e280be&_nc_ohc=nA33lAqrbGwQ7kNvwGJpTZk&_nc_oc=Adn_jphqnfK8ni8eVpvIq3kDa71REmuJQOqmn4SPPl9Dk0RZde9c20Lz75-xKV1FRnw&_nc_zt=14&_nc_ht=scontent-fra3-2.xx&_nc_gid=wpNJ_5noT4f2hHuDO-oppA\&oh=00_Afnz4slhvDc9gBXKlhYfQ5Ci49gLUfeg_BxaA7GVVBrhTg\&oe=69552FB2) When a WhatsApp user taps the message’s profile arrow, it displays the contact’s information in a profile view: ![](https://scontent-fra5-1.xx.fbcdn.net/v/t39.2365-6/441391825_1516000578987481_5920245070887074504_n.png?_nc_cat=100\&ccb=1-7&_nc_sid=e280be&_nc_ohc=TMxKLE-hV6sQ7kNvwF4HkW9&_nc_oc=Adm2UjCIifGz_r1wHKRUVASo7F4hI0-SHPy76GIN6eHXMMV6uDK5wfIIh84UHwRk7VA&_nc_zt=14&_nc_ht=scontent-fra5-1.xx&_nc_gid=wpNJ_5noT4f2hHuDO-oppA\&oh=00_Afl3szmJfbimJV-z5n1Shv3SbcT2hyyeRvHAQ9AsOqJTvw\&oe=69552C67) Each message can include information for up to 257 contacts, although it is recommended to send fewer for usability and negative feedback reasons. ## Request syntax Use the [POST /\/messages](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) endpoint to send a contacts message to a WhatsApp user. ``` curl 'https://graph.facebook.com/<API_VERSION>/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <ACCESS_TOKEN>' \ -d ' \{ "messaging_product": "whatsapp", "to": "<WHATSAPP_USER_PHONE_NUMBER>", "type": "contacts", "contacts": [\ {\ "addresses": [\ {\ "street": "<STREET_NUMBER_AND_NAME>",\ "city": "<CITY>",\ "state": "<STATE_CODE>",\ "zip": "<ZIP_CODE>",\ "country": "<COUNTRY_NAME>",\ "country_code": "<COUNTRY_CODE>",\ "type": "<ADDRESS_TYPE>"\ }\ \ ],\ "birthday": "<BIRTHDAY>",\ "emails": [\ {\ "email": "<EMAIL_ADDRESS>",\ "type": "<EMAIL_TYPE>"\ }\ \ ],\ "name": {\ "formatted_name": "<FULL_NAME>",\ "first_name": "<FIRST_NAME>",\ "last_name": "<LAST_NAME>",\ "middle_name": "<MIDDLE_NAME>",\ "suffix": "<SUFFIX>",\ "prefix": "<PREFIX>"\ },\ "org": {\ "company": "<COMPANY_OR_ORG_NAME>",\ "department": "<DEPARTMENT_NAME>",\ "title": "<JOB_TITLE>"\ },\ "phones": [\ "phone": "<PHONE_NUMBER>",\ "type": "<PHONE_NUMBER_TYPE>",\ "wa_id": "<WHATSAPP_USER_ID>"\ }\ \ ],\ "urls": [\ {\ "url": "<WEBSITE_URL>",\ "type": "<WEBSITE_TYPE>"\ }\ \ ]\ }\ ] }' ``` ## Request parameters | Placeholder | Description | Example Value | | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `<ACCESS_TOKEN>`
*String* | **Required.**
[System token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) or [business token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). | `EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD` | | `<ADDRESS_TYPE>`
*String* | **Optional.**
Type of address, such as home or work. | `Home` | | `<API_VERSION>`
*String* | **Optional.**
Graph API version. | v24.0 | | `<BIRTHDAY>`
*String* | **Optional.**
Contact’s birthday. Must be in YYYY-MM-DD format. | `1999-01-23` | | `<CITY>`
*String* | **Optional.**
City where the contact resides. | `Menlo Park` | | `<COMPANY_OR_ORG_NAME>`
*String* | **Optional.**
Name of the company where the contact works. | `Lucky Shrub` | | `<COUNTRY_CODE>`
*String* | **Optional.**
ISO two-letter country code. | `US` | | `<COUNTRY_NAME>`
*String* | **Optional.**
Country name. | `United States` | | `<DEPARTMENT_NAME>`
*String* | **Optional.**
Department within the company. | `Legal` | | `<EMAIL_ADDRESS>`
*String* | **Optional.**
Email address of the contact. | `bjohnson@luckyshrub.com` | | `<EMAIL_TYPE>`
*String* | **Optional.**
Type of email, such as personal or work. | `Work` | | `<FIRST_NAME>`
*String* | **Optional.**
Contact’s first name. | `Barbara` | | `<FORMATTED_NAME>`
*String* | **Required.**
Contact’s formatted name. This will appear in the message alongside the profile arrow button. | `Barbara J. Johnson` | | `<JOB_TITLE>`
*String* | **Optional.**
Contact’s job title. | `Lead Counsel` | | `<LAST_NAME>`
*String* | **Optional.**
Contact’s last name. | `Johnson` | | `<MIDDLE_NAME>`
*String* | **Optional.**
Contact’s middle name. | `Joana` | | `<PHONE_NUMBER>`
*String* | **Optional.**
WhatsApp user phone number. | `+16505559999` | | `<PHONE_NUMBER_TYPE>`
*String* | **Optional.**
Type of phone number. For example, cell, mobile, main, iPhone, home, work, etc. | `Home` | | `<PREFIX>`
*String* | **Optional.**
Prefix for the contact’s name, such as Mr., Ms., Dr., etc. | `Dr.` | | `<STATE_CODE>`
*String* | **Optional.**
Two-letter state code. | `CA` | | `<STREET_NUMBER_AND_NAME>`
*String* | **Optional.**
Street address of the contact. | `1 Lucky Shrub Way` | | `<SUFFIX>`
*String* | **Optional.**
Suffix for the contact’s name, if applicable. | `Esq.` | | `<WEBSITE_TYPE>`
*String* | **Optional.**
Type of website. For example, company, work, personal, Facebook Page, Instagram, etc. | `Company` | | `<WEBSITE_URL>`
*String* | **Optional.**
Website URL associated with the contact or their company. | `https://www.luckyshrub.com` | | `<WHATSAPP_USER_ID>`
*String* | **Optional.**
WhatsApp user ID. If omitted, the message will display an Invite to WhatsApp button instead of the standard buttons.
See [Button Behavior](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/contacts-messages#button-behavior) below. | `19175559999` | | `<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`
*String* | **Required.**
WhatsApp business phone number ID. | `106540352242922` | | `<WHATSAPP_USER_PHONE_NUMBER>`
*String* | **Required.**
WhatsApp user phone number. | `+16505551234` | | `<ZIP_CODE>`
*String* | **Optional.**
Postal or ZIP code. | `94025` | ## Button behavior 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: ![](https://scontent-fra5-1.xx.fbcdn.net/v/t39.2365-6/441399296_815661620463689_7258599973025915055_n.png?_nc_cat=102\&ccb=1-7&_nc_sid=e280be&_nc_ohc=jQZB57j0dOUQ7kNvwEWSZ5N&_nc_oc=Adm9HgXD3qlrgPUgKxW8X0KmeNxXdL5OlxYDNQUVJb5ZT11lPjbDchH_FZUlSCvbzFs&_nc_zt=14&_nc_ht=scontent-fra5-1.xx&_nc_gid=wpNJ_5noT4f2hHuDO-oppA\&oh=00_AfnP6WE_B2BkaZbp8724SEQ2zS2Y-5lOPiAAf-z-AFOCIw\&oe=6954FDEA) 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. If you omit the `wa_id` property, both buttons will be replaced with an **Invite to WhatsApp** button: ![](https://scontent-fra3-2.xx.fbcdn.net/v/t39.2365-6/441366594_855962089669296_5557083162637364924_n.png?_nc_cat=111\&ccb=1-7&_nc_sid=e280be&_nc_ohc=9YYba8ppUOEQ7kNvwGG6_gP&_nc_oc=Adk4VmT0fNpL-ffRJ7T_m8oN1BgIOnzPJ2uJ49zSPPpAEl4X0yTijDJcLuTohw5yr3I&_nc_zt=14&_nc_ht=scontent-fra3-2.xx&_nc_gid=wpNJ_5noT4f2hHuDO-oppA\&oh=00_AfkKhNfV6ckSNq9hi6e9kXQEHkK1g6oxrOuja9PZd_KIpw\&oe=69551C17) ## Example request Example request to send a contacts message with two physical addresses, two email addresses, two phone numbers, and two website URLs. ``` curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' \{ "messaging_product": "whatsapp", "to": "+16505551234", "type": "contacts", "contacts": [\ {\ "addresses": [\ {\ "street": "1 Lucky Shrub Way",\ "city": "Menlo Park",\ "state": "CA",\ "zip": "94025",\ "country": "United States",\ "country_code": "US",\ "type": "Office"\ },\ {\ "street": "1 Hacker Way",\ "city": "Menlo Park",\ "state": "CA",\ "zip": "94025",\ "country": "United States",\ "country_code": "US",\ "type": "Pop-Up"\ }\ ],\ "birthday": "1999-01-23",\ "emails": [\ {\ "email": "bjohnson@luckyshrub.com",\ "type": "Work"\ },\ {\ "email": "bjohnson@luckyshrubplants.com",\ "type": "Work (old)"\ }\ ],\ "name": {\ "formatted_name": "Barbara J. Johnson",\ "first_name": "Barbara",\ "last_name": "Johnson",\ "middle_name": "Joana",\ "suffix": "Esq.",\ "prefix": "Dr."\ },\ "org": {\ "company": "Lucky Shrub",\ "department": "Legal",\ "title": "Lead Counsel"\ },\ "phones": [\ {\ "phone": "+16505559999",\ "type": "Landline"\ },\ {\ "phone": "+19175559999",\ "type": "Mobile",\ "wa_id": "19175559999"\ }\ ],\ "urls": [\ {\ "url": "https://www.luckyshrub.com",\ "type": "Company"\ },\ {\ "url": "https://www.facebook.com/luckyshrubplants",\ "type": "Company (FB)"\ }\ ]\ }\ ] }' ``` ## Example response ``` \{ "messaging_product": "whatsapp", "contacts": [\ {\ "input": "+16505551234",\ "wa_id": "16505551234"\ }\ ], "messages": [\ {\ "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"\ }\ ] } ``` Did you find this page helpful? ![Thumbs up icon](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg) ![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg) ON THIS PAGE Request syntax Request parameters Button behavior Example request Example response ***