Skip to main content

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’user's location details.

Request syntax

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages 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







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’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’user's message.





1702920965






<WHATSAPP_BUSINESS_ACCOUNT_ID>


String





WhatsApp Business Account ID.





102290129340398






<WHATSAPP_BUSINESS_DISPLAY_PHONE_NUMBER>


String





WhatsApp business phone number’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’user's message.





wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQTRCRDcwNzgzMTRDNTAwRTgwRQA=






<WHATSAPP_USER_ID>


String





WhatsApp user’user's WhatsApp ID.





16505551234






<WHATSAPP_USER_NAME>


String





WhatsApp user’user's name.





Pablo Morales






Example
request
curl 'https://graph.facebook.com/v25.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"
        }
      ]
    }
  ]
}

    
        

    


            

        

    


    


    
    

        

             Back to top