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.
System token or business token.
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<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