Skip to main content
POST
/
api
/
v1
/
messages
/
location
Send a location message
curl --request POST \
  --url https://api.wazzapi.io/api/v1/messages/location \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone": "+1234567890",
  "latitude": 40.7128,
  "longitude": -74.006,
  "whatsappAccountId": "wa_abc123def456"
}
'
{
  "success": true,
  "message": {
    "id": "msg_1234567890",
    "status": "queued",
    "runId": "run_abc123",
    "createdAt": "2025-01-15T10:30:00.000Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as Bearer YOUR_API_KEY. API keys can be created from the dashboard.

Body

application/json
​
phone
string
required

Recipient phone number in international format (E.164)

Minimum string length: 1
Example:

"+1234567890"

​
latitude
number<double>
required

Latitude coordinate

Required range: -90 <= x <= 90
Example:

40.7128

​
longitude
number<double>
required

Longitude coordinate

Required range: -180 <= x <= 180
Example:

-74.006

​
whatsappAccountId
string
required

ID of the WhatsApp account to send from. Must be in 'connected' status.

Minimum string length: 1
Example:

"wa_abc123def456"

​
title
string

Optional title for the location

Maximum string length: 100
Example:

"Headquarters"

​
address
string

Optional address text for the location

Maximum string length: 255
Example:

"123 Main St, New York, NY 10001"

Response

Message queued successfully

​
success
boolean
required

Indicates if the message was queued successfully

Example:

true

​
message
object
required