---
title: "Send Location"
method: POST
path: "/message/sendLocation/{instance}"
tags: ["Message Controller"]
---

# Send Location

`POST /message/sendLocation/{instance}`

Send Location

## Path parameters

- `instance` string, required

## Request body

- object
  - `number` string, required — Number to receive the message (with country code)
  - `name` string, required — Name the city
  - `address` string, required — Location address
  - `latitude` number, required — Latitude location
  - `longitude` number, required — Longitude location
  - `delay` integer — Presence time in milliseconds before sending message
  - `linkPreview` boolean — Shows a preview of the target website if there's a link within the message
  - `mentionsEveryOne` boolean — Mentioned everyone when the message send
  - `mentioned` string[] — Numbers to mention
  - `quoted` object
    - `key` object
      - `id` string — Quoted message ID
    - `message` object
      - `conversation` string — Quoted message content

## Response `201`

Created

- object
  - `key` object — The key of the message, which identifies the message in the chat.
    - `remoteJid` string — The remote Jid.
    - `fromMe` boolean — Indicates whether the message was sent by the user.
    - `id` string — The ID of the message.
  - `message` object — The message content, which may include various types of messages like text, images, location, etc.
    - `locationMessage` object — Details of the location message.
      - `degreesLatitude` number, float — The latitude of the location.
      - `degreesLongitude` number, float — The longitude of the location.
      - `name` string — The name of the location.
      - `address` string — The address of the location.
      - `contextInfo` object — Additional context information.
  - `messageTimestamp` string — The timestamp of the message, represented as a string.
  - `status` string — The status of the message, such as sent, received, or pending.

## Changes

- **2024-10-29** (v2) `f4f5817334cd` — 1 warning, 5 info
  - removed the request property `options`
  - added the new optional request property `delay`
  - added the new optional request property `linkPreview`
  - added the new optional request property `mentioned`
  - …2 more
- **2024-10-21** (v2) `058a82a87836` — 4 breaking, 2 warning, 4 info
  - added the new required request property `address`
  - added the new required request property `latitude`
  - added the new required request property `longitude`
  - added the new required request property `name`
  - …6 more
- **2024-10-14** (v2) `c153448703e5` — 3 breaking, 6 info
  - added the new required request property `locationMessage`
  - added the new required request property `number`
  - removed the success response with the status `200`
  - api operation id `sendLocation` was added
  - …5 more
- **2024-09-09** (v2) `0c4620ca5ed5` — 1 breaking, 9 warning, 5 info
  - removed the success response with the status `201`
  - removed the request property `address`
  - removed the request property `delay`
  - removed the request property `latitude`
  - …11 more
- **2024-06-13** (v2) `996acfdb07ce` — 2 breaking, 2 warning, 6 info
  - added the new required request property `latitude`
  - added the new required request property `longitude`
  - removed the request property `locationMessage`
  - removed the request property `options`
  - …6 more

[Change history](https://skmtc.dev/evolution-foundation/apis/openapi/changes/message/sendLocation/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/openapi.md) · [All operations](https://skmtc.dev/evolution-foundation/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolution-foundation/openapi/revisions/153363ee7f38/schema)