Send a live location update

Sends a live (moving) location point to a WhatsApp contact or group through WUTS, optionally including accuracy, speed, heading, sequence number, time offset, caption, and a JPEG thumbnail.

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.

accuracy_in_meters?integer

Optional location accuracy in meters.

speed_in_mps?number

Optional speed in meters per second.

degrees_clockwise_from_magnetic_north?integer

Optional heading in degrees clockwise from magnetic north.

caption?string

Optional caption for the live location.

sequence_number?integer

Optional sequence number for ordering live location updates.

time_offset?integer

Optional time offset.

duration_in_seconds?integer

Duration in seconds (max 3600 = 1 hour).

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/live-location" \  -H "Content-Type: application/json" \  -d '{    "to": "5511999999999",    "latitude": -23.55052,    "longitude": -46.633308,    "accuracy_in_meters": 12,    "speed_in_mps": 1.4,    "degrees_clockwise_from_magnetic_north": 90,    "caption": "On my way",    "sequence_number": 1,    "time_offset": 0,    "duration_in_seconds": 900  }'

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

{  "error": "WhatsApp not connected"}

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

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

Send a live location update

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`