# Contacts messages webhook reference | Developer Documentation

<div id="bkmrk-contacts-messages-we">## Contacts messages webhook reference

<div><span>Updated: Oct 22, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **messages** webhook for messages containing one or more contacts.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A WhatsApp user sends one or more contacts to a business.</span><span>A WhatsApp user sends one or more contacts to a business via a Click to WhatsApp ad.</span><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>### 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>`<AD_CLICK_ID>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad click ID.</div><div>The `ctwa_clid` property is omitted entirely for messages originating from an ad in WhatsApp Status ([WhatsApp Status ad placements<span>?</span>](https://www.facebook.com/business/help/1074444721456755)).</div></div></td><td><div><div>```
Aff-n8ZTODiE79d22KtAwQKj9e_mIEOOj27vDVwFjN80dp4_0NiNhEgpGo0AHemvuSoifXaytfTzcchptiErTKCqTrJ5nW1h7IHYeYymGb5K5J5iTROpBhWAGaIAeUzHL50
```

</div></div></td></tr><tr><td><div><div>`<AD_GREETING_TEXT>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad greeting text.</div></div></td><td><div><div>`Hi there! Let us know how we can help!`</div></div></td></tr><tr><td><div><div>`<AD_HEADLINE>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad headline.</div></div></td><td><div><div>`Chat with us`</div></div></td></tr><tr><td><div><div>`<AD_ID>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad ID.</div></div></td><td><div><div>`120226305854810726`</div></div></td></tr><tr><td><div><div>`<AD_IMAGE_URL>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad image URL. Only included if the ad is an image ad.</div></div></td><td><div><div>`https://scontent.xx.fbcdn.net/v/t45.1...`</div></div></td></tr><tr><td><div><div>`<AD_MEDIA_TYPE>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad media type. Values can be:</div><div>`image` - Indicates an image ad.</div><div>`video` - Indicates a video ad.</div></div></td><td><div><div>`image`</div></div></td></tr><tr><td><div><div>`<AD_PRIMARY_TEXT>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad primary text.</div></div></td><td><div><div>`Summer succulents are here!`</div></div></td></tr><tr><td><div><div>`<AD_URL>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad URL.</div></div></td><td><div><div>`https://fb.me/3cr4Wqqkv`</div></div></td></tr><tr><td><div><div>`<AD_VIDEO_THUMBNAIL>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad video thumbnail URL. Only included if ad is a video ad.</div></div></td><td><div><div>`https://scontent.xx.fbcdn.net/v/t45.3...`</div></div></td></tr><tr><td><div><div>`<AD_VIDEO_URL>`</div><div>*String*</div></div></td><td><div><div>Click to WhatsApp ad video URL. Only included if ad is a video ad.</div></div></td><td><div><div>`https://scontent.xx.fbcdn.net/v/t45.2...`</div></div></td></tr><tr><td><div><div>`<BUSINESS_DISPLAY_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>Business display phone number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>Business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<CONTACT_ADDRESS_TYPE>`</div><div>*String*</div></div></td><td><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>`<CONTACT_BIRTHDAY>`</div><div>*String*</div></div></td><td><div><div>Contact birthday.</div></div></td><td><div><div>`1999-01-23`</div></div></td></tr><tr><td><div><div>`<CONTACT_CITY>`</div><div>*String*</div></div></td><td><div><div>City mentioned in the contact address.</div></div></td><td><div><div>`Menlo Park`</div></div></td></tr><tr><td><div><div>`<CONTACT_COUNTRY_CODE>`</div><div>*String*</div></div></td><td><div><div>ISO country code on the contact address.</div></div></td><td><div><div>`US`</div></div></td></tr><tr><td><div><div>`<CONTACT_COUNTRY>`</div><div>*String*</div></div></td><td><div><div>Country mentioned in the contact address.</div></div></td><td><div><div>`United States`</div></div></td></tr><tr><td><div><div>`<CONTACT_EMAIL_TYPE>`</div><div>*String*</div></div></td><td><div><div>Type of email, such as personal or work.</div></div></td><td><div><div>`Personal`</div></div></td></tr><tr><td><div><div>`<CONTACT_EMAIL>`</div><div>*String*</div></div></td><td><div><div>Email address of the contact.</div></div></td><td><div><div>`bjohson@socialtsunami.com`</div></div></td></tr><tr><td><div><div>`<CONTACT_FIRST_NAME>`</div><div>*String*</div></div></td><td><div><div>Contact's first name.</div></div></td><td><div><div>`Barbara`</div></div></td></tr><tr><td><div><div>`<CONTACT_FORMATTED_NAME>`</div><div>*String*</div></div></td><td><div><div>Contact's formatted name.</div></div></td><td><div><div>`Barbara J. Johnson`</div></div></td></tr><tr><td><div><div>`<CONTACT_LAST_NAME>`</div><div>*String*</div></div></td><td><div><div>Contact's last name.</div></div></td><td><div><div>`Johnson`</div></div></td></tr><tr><td><div><div>`<CONTACT_MIDDLE_NAME>`</div><div>*String*</div></div></td><td><div><div>Contact's middle name.</div></div></td><td><div><div>`Joana`</div></div></td></tr><tr><td><div><div>`<CONTACT_NAME_PREFIX>`</div><div>*String*</div></div></td><td><div><div>Contact's name prefix.</div></div></td><td><div><div>`Dr.`</div></div></td></tr><tr><td><div><div>`<CONTACT_NAME_SUFFIX>`</div><div>*String*</div></div></td><td><div><div>Contact's name suffix.</div></div></td><td><div><div>`Esq.`</div></div></td></tr><tr><td><div><div>`<CONTACT_ORG_COMPANY>`</div><div>*String*</div></div></td><td><div><div>Name of the company where the contact works.</div></div></td><td><div><div>`Social Tsunami`</div></div></td></tr><tr><td><div><div>`<CONTACT_ORG_DEPARTMENT>`</div><div>*String*</div></div></td><td><div><div>Name of the department where the contact works.</div></div></td><td><div><div>`Engineering`</div></div></td></tr><tr><td><div><div>`<CONTACT_ORG_TITLE>`</div><div>*String*</div></div></td><td><div><div>Contact's job title.</div></div></td><td><div><div>`Software Engineer`</div></div></td></tr><tr><td><div><div>`<CONTACT_PHONE_TYPE>`</div><div>*String*</div></div></td><td><div><div>Type of phone number. For example, cell, mobile, main, iPhone, home, work, etc.</div></div></td><td><div><div>`CELL`</div></div></td></tr><tr><td><div><div>`<CONTACT_PHONE>`</div><div>*String*</div></div></td><td><div><div>Contact's phone number.</div></div></td><td><div><div>`+14125550829`</div></div></td></tr><tr><td><div><div>`<CONTACT_STATE>`</div><div>*String*</div></div></td><td><div><div>State mentioned in the contact address.</div></div></td><td><div><div>`CA`</div></div></td></tr><tr><td><div><div>`<CONTACT_STREET>`</div><div>*String*</div></div></td><td><div><div>Street mentioned in the contact address.</div></div></td><td><div><div>`1 Hacker Way`</div></div></td></tr><tr><td><div><div>`<CONTACT_URL_TYPE>`</div><div>*String*</div></div></td><td><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>`<CONTACT_URL>`</div><div>*String*</div></div></td><td><div><div>Website URL associated with the contact or their company.</div></div></td><td><div><div>`socialtsunami.com`</div></div></td></tr><tr><td><div><div>`<CONTACT_WHATSAPP_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>Contact's WhatsApp number.</div></div></td><td><div><div>`14125550829`</div></div></td></tr><tr><td><div><div>`<CONTACT_ZIP>`</div><div>*String*</div></div></td><td><div><div>Zip code in the contact address.</div></div></td><td><div><div>`94025`</div></div></td></tr><tr><td><div><div>`<IDENTITY_KEY_HASH>`</div><div>*String*</div></div></td><td><div><div>Identity key hash. Only included if you have enabled the [identity change check](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation) feature.</div></div></td><td><div><div>`DF2lS5v2W6x=`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*String*</div></div></td><td><div><div>Unix timestamp indicating when the webhook was triggered.</div></div></td><td><div><div>`1739321024`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_ACCOUNT_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID.</div></div></td><td><div><div>`wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user ID. Note that a WhatsApp user's ID and phone number may not always match.</div></div></td><td><div><div>`16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user phone number. This is the same value returned by the API as the `input` value when sending a message to a WhatsApp user. Note that a WhatsApp user's phone number and ID may not always match.</div></div></td><td><div><div>`+16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_PROFILE_NAME>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user's name as it appears in their profile in the WhatsApp client.</div></div></td><td><div><div>`Sheena Nelson`</div></div></td></tr></tbody></table>

</div></div>