Send a static location

Sends a pinned geographic location to a WhatsApp contact or group through WUTS. Latitude and longitude are required; an optional name, address, URL, comment, and JPEG thumbnail (base64 or remote URL) can be attached.

Authorization

bearerAuth

AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*string

Recipient phone number or WhatsApp JID (user or group).

latitude*number

Latitude in decimal degrees.

longitude*number

Longitude in decimal degrees.

name?string

Optional location name.

address?string

Optional address.

url?string

Optional URL for the location.

comment?string

Optional comment/caption.

thumbnail?string

Optional base64 thumbnail (JPEG); a data URL prefix is stripped automatically.

thumbnail_url?string

Optional thumbnail URL; WUTS downloads the JPEG (up to 100KB).

Response Body

`application/json`

curl -X POST "https://example.com/send/location" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "latitude": -23.55052,    "longitude": -46.633308,    "name": "Praca da Se",    "address": "Praca da Se, Se, Sao Paulo - SP",    "url": "https://maps.example.com/?q=-23.55052,-46.633308",    "comment": "Meet me here at noon"  }'

{  "success": true,  "message_id": "3EB0X1A2B3C4D5E6F7",  "timestamp": "2026-06-15T12:00:00Z",  "message": "Location sent successfully"}

{  "error": "Invalid recipient JID: invalid number"}

{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

{  "error": "Failed to send location: timeout"}

Send a static location

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`