Skip to main content
Display a Send Location button. When the user taps it and shares, you receive an inbound location webhook.

​
Request

curl -X POST "${WHATSAPP_API_URL}/${WHATSAPP_PHONE_NUMBER_ID}/messages" \
  -H "Authorization: Bearer ${WHATSAPP_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "messaging_product": "whatsapp",
  "to": "15551234567",
  "type": "interactive",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "Please share your location so we can estimate delivery."
    },
    "action": {
      "name": "send_location"
    }
  }
}'

​
Response handling

When the user shares their location, your webhook receives: 
{
  "type": "location",
  "location": {
    "latitude": 37.7749,
    "longitude": -122.4194,
    "name": "Optional name",
    "address": "Optional address"
  }
}

​
Use cases

  • Delivery services requesting drop-off locations
  • Store locators finding the nearest branch
  • Field-service appointments and event check-ins