> ## 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. # Location request messages # 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. ![](https://scontent-fra3-1.xx.fbcdn.net/v/t39.2365-6/411712787_1346691626211128_4092487602815472288_n.png?_nc_cat=105\&ccb=1-7&_nc_sid=e280be&_nc_ohc=Drt5IOf1j-sQ7kNvwFXRVI2&_nc_oc=AdnTcSjkUFoFchXCkFGAd2j0WotB66kVThGg0i3uFVUh8OUPQj_owdlM80ImnN5Y0gw&_nc_zt=14&_nc_ht=scontent-fra3-1.xx&_nc_gid=ie2Hiuu87Cd_avsHq0TF_Q\&oh=00_Afn799VB3uIs3pL5-IxhmOwyrLk7A8xncku4tUcACE2rIw\&oe=69550CEA) Once the user shares their location, a **messages** webhook is triggered, containing the user’s location details. ## 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 location request 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", "recipient_type": "individual", "type": "interactive", "to": "<WHATSAPP_USER_PHONE_NUMBER>", "interactive": { "type": "location_request_message", "body": { "text": "<BODY_TEXT>" }, "action": { "name": "send_location" } } }' ``` ## 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` | | `<API_VERSION>`
*String* | **Optional.**
Graph API version. | v24.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. ``` \{ "object": "whatsapp_business_account", "entry": [\ {\ "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",\ "changes": [\ {\ "value": {\ "messaging_product": "whatsapp",\ "metadata": {\ "display_phone_number": "<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>",\ "phone_number_id": "<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>"\ },\ "contacts": [\ {\ "profile": {\ "name": "<WHATSAPP_USER_NAME>"\ },\ "wa_id": "<WHATSAPP_USER_ID>"\ }\ ],\ "messages": [\ {\ "context": {\ "from": "<WHATSAPP_BUSINESS_PHONE_NUMBER>",\ "id": "<WHATSAPP_CONTEXT_MESSAGE_ID>"\ },\ "from": "<WHATSAPP_USER_ID>",\ "id": "<WHATSAPP_MESSAGE_ID>",\ "timestamp": "<TIMESTAMP>",\ "location": {\ "address": "<LOCATION_ADDRESS>",\ "latitude": <LOCATION_LATITUDE>,\ "longitude": <LOCATION_LONGITUDE>,\ "name": "<LOCATION_NAME>"\ },\ "type": "location"\ }\ ]\ },\ "field": "messages"\ }\ ]\ }\ ] } ``` ## 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` | ## Example request ``` curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' \{ "messaging_product": "whatsapp", "recipient_type": "individual", "type": "interactive", "to": "+16505551234", "interactive": { "type": "location_request_message", "body": { "text": "Let'\''s start with your pickup. You can either manually *enter an address* or *share your current location*." }, "action": { "name": "send_location" } } }' ``` ## Example response ``` \{ "messaging_product": "whatsapp", "contacts": [\ {\ "input": "+16505551234",\ "wa_id": "16505551234"\ }\ ], "messages": [\ {\ "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBJCNUQ5RUNBNTk3OEQ2M0ZEQzgA"\ }\ ] } ``` ## Example webhook ``` \{ "object": "whatsapp_business_account", "entry": [\ {\ "id": "102290129340398",\ "changes": [\ {\ "value": {\ "messaging_product": "whatsapp",\ "metadata": {\ "display_phone_number": "15550783881",\ "phone_number_id": "106540352242922"\ },\ "contacts": [\ {\ "profile": {\ "name": "Pablo Morales"\ },\ "wa_id": "16505551234"\ }\ ],\ "messages": [\ {\ "context": {\ "from": "15550783881",\ "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1QjJGRjI1RDY0RkE4Nzg4QzcA"\ },\ "from": "16505551234",\ "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=",\ "timestamp": "1702920965",\ "location": {\ "address": "1071 5th Ave, New York, NY 10128",\ "latitude": 40.782910059774,\ "longitude": -73.959075808525,\ "name": "Solomon R. Guggenheim Museum"\ },\ "type": "location"\ }\ ]\ },\ "field": "messages"\ }\ ]\ }\ ] } ``` 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 Webhook syntax Webhook parameters Example request Example response Example webhook ***