Send location

Drop a map pin so customers know where to go — stores, pickup points, job sites, or event venues.

At a glance

Item	Detail
`type`	`location`
Channel support	Official and unofficial
Coordinates	Decimal degrees (`latitude`, `longitude`)

Request body

Field	Required	Description
`channel_id`	Yes	Sender channel ID
`to`	Yes	Recipient phone number
`type`	Yes	`location`
`content.name`	Yes	Place name
`content.address`	Yes	Address label
`content.latitude`	Yes	Latitude
`content.longitude`	Yes	Longitude

Example

curl -X POST "https://api.wazapin.com/v1/messages" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": "wzp_abc123",
    "to": "6281234567890",
    "type": "location",
    "content": {
      "name": "Wazapin Office",
      "address": "Jakarta Selatan",
      "latitude": -6.260697,
      "longitude": 106.781616
    }
  }'

import { WazapinClient, locationMessage } from "@wazapin/sdk";

const wazapin = new WazapinClient({ apiKey: process.env.WAZAPIN_API_KEY! });

await wazapin.messages.send(
  locationMessage({
    channel_id: "wzp_abc123",
    to: "6281234567890",
    name: "Wazapin Office",
    address: "Jakarta Selatan",
    latitude: -6.260697,
    longitude: 106.781616,
  }),
);

import requests

requests.post(
    "https://api.wazapin.com/v1/messages",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
        "channel_id": "wzp_abc123",
        "to": "6281234567890",
        "type": "location",
        "content": {
            "name": "Wazapin Office",
            "address": "Jakarta Selatan",
            "latitude": -6.260697,
            "longitude": 106.781616,
        },
    },
    timeout=30,
).raise_for_status()

Endpoint

POST https://api.wazapin.com/v1/messages

Authenticate with X-Api-Key. See Authentication.

Response

On success, the API returns 201 Created with a message record (status often starts as queued).

{
  "data": {
    "id": "9f1fd66d-c37a-4b50-a8c2-b4dca523f9c8",
    "channel_id": "wzp_abc123",
    "to_phone": "6281234567890",
    "type": "text",
    "status": "queued",
    "created_at": "2026-03-04T06:20:10Z",
    "updated_at": "2026-03-04T06:20:10Z"
  }
}

Track delivery with Webhooks or GET /v1/messages/{messageID}.