Location request messages | Developer Documentation
Location request messages
Updated: Nov 3, 2025
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.
Once the user shares their location, a messages webhook is triggered, containing the user's location details.
Request parameters
| Placeholder | Description | Example Value |
|---|---|---|
<ACCESS_TOKEN>String |
Required.
|
|
<API_VERSION>String |
Optional.
Graph API version. |
v25.0 |
<BODY_TEXT>String |
Required.
Message body text. Supports URLs.
Maximum 1024 characters. |
Let's start with your pickup. You can either manually *enter an address* or *share your current location*. |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>String |
Required.
WhatsApp business phone number ID. |
106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>String |
Required.
WhatsApp user phone number. |
+16505551234 |
Webhook syntax
When a WhatsApp user shares their location in response to your message, a messages webhook is triggered containing the user's location details.
Webhook parameters
| Placeholder | Description | Example Value |
|---|---|---|
<LOCATION_ADDRESS>String |
Location address.
This parameter will only appear if the WhatsApp user chooses to share it. |
1071 5th Ave, New York, NY 10128 |
<LOCATION_LATITUDE>Number |
Location latitude in decimal degrees. |
40.782910059774 |
<LOCATION_LONGITUDE>Number |
Location longitude in decimal degrees. |
-73.959075808525 |
<LOCATION_NAME>String |
Location name.
This parameter will only appear if the WhatsApp user chooses to share it. |
Solomon R. Guggenheim Museum |
<TIMESTAMP>String |
UNIX timestamp indicating when our servers processed the WhatsApp user's message. |
1702920965 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>String |
WhatsApp Business Account ID. |
102290129340398 |
<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>String |
WhatsApp business phone number's display number. |
15550783881 |
<WHATSAPP_BUSINESS_PHONE_NUMBER>String |
WhatsApp business phone number. |
15550783881 |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>String |
WhatsApp business phone number ID. |
106540352242922 |
<WHATSAPP_CONTEXT_MESSAGE_ID>String |
WhatsApp message ID of message that the user is responding to. |
wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA |
<WHATSAPP_MESSAGE_ID>String |
WhatsApp message ID of the user's message. |
wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA= |
<WHATSAPP_USER_ID>String |
WhatsApp user's WhatsApp ID. |
16505551234 |
<WHATSAPP_USER_NAME>String |
WhatsApp user's name. |
Pablo Morales |