# Location request messages | Developer Documentation

<div id="bkmrk-location-request-mes">## Location request messages

<div><span>Updated: Nov 3, 2025</span></div><div>Location request messages display **body text** and a **send location button**. When a WhatsApp user taps the button, a location sharing screen appears which the user can then use to share their location.</div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-stixqhzs.png)</div></div><div>  
Once the user shares their location, a **messages** webhook is triggered, containing the user's location details.</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>`<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>`<BODY_TEXT>`</div><div>*String*</div></div></td><td><div><div>**Required.**</div><div>Message body text. Supports URLs.</div><div>Maximum 1024 characters.</div></div></td><td><div><div>`Let's start with your pickup. You can either manually *enter an address* or *share your current location*.`</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></tbody></table>

</div><div id="bkmrk-webhook-syntax"><div id="bkmrk-webhook-syntax-1"><div>### Webhook syntax

</div></div></div><div>When a WhatsApp user shares their location in response to your message, a **messages** webhook is triggered containing the user's location details.</div><div id="bkmrk-webhook-parameters"><div id="bkmrk-webhook-parameters-1"><div>### Webhook 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>`<LOCATION_ADDRESS>`</div><div>*String*</div></div></td><td><div><div>Location address.</div><div>This parameter will only appear if the WhatsApp user chooses to share it.</div></div></td><td><div><div>`1071 5th Ave, New York, NY 10128`</div></div></td></tr><tr><td><div><div>`<LOCATION_LATITUDE>`</div><div>*Number*</div></div></td><td><div><div>Location latitude in decimal degrees.</div></div></td><td><div><div>`40.782910059774`</div></div></td></tr><tr><td><div><div>`<LOCATION_LONGITUDE>`</div><div>*Number*</div></div></td><td><div><div>Location longitude in decimal degrees.</div></div></td><td><div><div>`-73.959075808525`</div></div></td></tr><tr><td><div><div>`<LOCATION_NAME>`</div><div>*String*</div></div></td><td><div><div>Location name.</div><div>This parameter will only appear if the WhatsApp user chooses to share it.</div></div></td><td><div><div>`Solomon R. Guggenheim Museum`</div></div></td></tr><tr><td><div><div>`<TIMESTAMP>`</div><div>*String*</div></div></td><td><div><div>UNIX timestamp indicating when our servers processed the WhatsApp user's message.</div></div></td><td><div><div>`1702920965`</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_BUSINESS_DISPLAY_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>WhatsApp business phone number's display number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>WhatsApp business phone number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp business phone number ID.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_CONTEXT_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID of message that the user is responding to.</div></div></td><td><div><div>`wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_MESSAGE_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp message ID of the user's message.</div></div></td><td><div><div>`wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user's WhatsApp ID.</div></div></td><td><div><div>`16505551234`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_USER_NAME>`</div><div>*String*</div></div></td><td><div><div>WhatsApp user's name.</div></div></td><td><div><div>`Pablo Morales`</div></div></td></tr></tbody></table>

</div></div>