HomeUser GuidesAPI Reference
Get Started
HomeAPI Reference
Authentication
Branches
Contact Groups
Contacts
Conversations
Error HandlingInvoices
Messages
Orders
Rate LimitingSDKs & Code ExamplesTemplatesTicketsAPI VersioningWABA NumbersWebhooks
User GuideAPI ReferenceMessagesSend Location Message

Send Location Message

Share precise geographic locations

Reading time: 1 minute

Send Location Message

Share geographic location with precise coordinates.

POST{{base_url}}/w/message/location

Query Parameters

ParameterTypeRequiredDescription
phone_number_idstringYesPhone number ID of the sender

Request Body (JSON)

ParameterTypeRequiredDescription
phonestringYesRecipient phone number
locationobjectYesLocation object

Location Specifications

ParameterTypeRequiredDescription
latitudefloatYesLatitude (from -90 to 90)
longitudefloatYesLongitude (from -180 to 180)
namestringYesLocation name
addressstringYesFull address

Example Request

Example Requestbash
curl -X POST "{{base_url}}/w/message/location?phone_number_id=123456" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Awal-Signature-256: sha256=abc..." \
-H "X-Timestamp: 1704124800" \
-H "X-Domain: your-workspace" \
-H "X-Client-ID: your-client-id" \
-d '{
  "phone": "96650000000",
  "location": {
    "latitude": 24.7136,
    "longitude": 46.6753,
    "name": "Riyadh Park",
    "address": "King Fahd Road, Riyadh, Saudi Arabia"
  }
}'

Practical Uses:

  • Send your store location to customers
  • Share delivery location
  • Set meeting point

Related

← Back to Messages
View Guide
View