Waplix
Docs

Send Location

Supported & Tested

Send direct GPS location coordinate cards.

POSThttps://api.waplix.io/api/v1/messages/location
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Waplix instance id slot

number
stringReq

Recipient phone number

latitude
numberReq

GPS Latitude coordinate float (-90 to 90)

longitude
numberReq

GPS Longitude coordinate float (-180 to 180)

name
stringOpt

Optional place name custom header

address
stringOpt

Optional place street address detail text

Request Payload Example
Request 
curl -X POST "https://api.waplix.io/api/v1/api/v1/messages/location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "demo_instance",
  "number": "15551234567",
  "latitude": 24.8607,
  "longitude": 67.0011,
  "name": "John Doe"
}'
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "message_id": "MSG_DEMO_001",
    "instance_id": "demo_instance",
    "to": "15551234567@s.whatsapp.net",
    "type": "location",
    "latitude": 24.8607,
    "longitude": 67.0011,
    "name": "John Doe",
    "address": null,
    "status": "sent"
  }
}
Related Webhook Events

The API response confirms that Waplix accepted or processed the request. Delivery and read updates may arrive asynchronously through configured webhooks.

message.sentDocs →

Triggered when Waplix successfully sends the location message.

{
  "event": "message.sent",
  "instance_id": "demo_instance",
  "to": "15551234567@s.whatsapp.net",
  "message_type": "location",
  "latitude": 24.8607,
  "longitude": 67.0011,
  "name": "John Doe",
  "address": null,
  "message_id": "MSG_DEMO_001",
  "timestamp": 1782582266
}
message.deliveredDocs →

Triggered when the location message is delivered to the recipient.

{
  "event": "message.delivered",
  "instance_id": "demo_instance",
  "message_id": "MSG_DEMO_001",
  "chat_id": "15551234567@s.whatsapp.net",
  "from": null,
  "to": "15551234567@s.whatsapp.net",
  "message_type": "location",
  "status": "DELIVERY_ACK",
  "receipts": [],
  "timestamp": 1782582267
}
message.readDocs →

Triggered when the recipient opens/reads the location message.

{
  "event": "message.read",
  "instance_id": "demo_instance",
  "message_id": "MSG_DEMO_001",
  "chat_id": "15551234567@s.whatsapp.net",
  "from": null,
  "to": "15551234567@s.whatsapp.net",
  "message_type": "location",
  "status": "READ",
  "receipts": [],
  "timestamp": 1782582268
}
Previous Send View Once MediaNext Send Contact (vCard)
Was this page helpful?