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

# Send Status

`POST /message/sendStatus/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/message/sendStatus/{instance}`
- Auth: API key in header `apikey`

Post WhatsApp status (stories)

## Path parameters

- `instance` string, required

## Request body

- object
  - `type` 'text' | 'image' | 'audio', required: status type
  - `content` string, required: status type
  - `caption` string, required: Optional for image or video
  - `backgroundColor` string, required: Exemple #008000
  - `font` number, required: 1 = SERIF 2 = NORICAN_REGULAR 3 = BRYNDAN_WRITE 4 = BEBASNEUE_REGULAR 5 = OSWALD_HEAVY
  - `allContacts` boolean, required: true to send to all contacts or false to send to statusJidList below
  - `statusJidList` string[], required: Numbers to send status

## 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, etc.
    - `extendedTextMessage` object: Details of the extended text message.
      - `text` string: The text content of the message.
      - `backgroundArgb` integer: The background color of the text message, represented as ARGB integer value.
      - `font` string: The font used in the text message.
  - `messageTimestamp` string: The timestamp of the message, represented as a string.
  - `status` string: The status of the message, such as sent, received, or pending.
  - `participant` string: The participant in the chat to whom the message was sent.

## Changes

- **2024-11-25** (v2) `3c612f18e124`: 7 breaking, 1 warning
  - added the new required request property `allContacts`
  - added the new required request property `backgroundColor`
  - added the new required request property `caption`
  - added the new required request property `content`
  - …4 more
- **2024-11-25** (v2) `c153448703e5`: 2 breaking, 5 info
  - added the new required request property `statusMessage`
  - removed the success response with the status `200`
  - api operation id `sendStatus` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - …3 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 breaking, 7 warning, 5 info
  - removed the success response with the status `201`
  - removed the request property `allContacts`
  - removed the request property `backgroundColor`
  - removed the request property `caption`
  - …9 more
- **2024-08-09** (v2) `996acfdb07ce`: 2 breaking, 1 warning, 5 info
  - added the new required request property `content`
  - added the new required request property `type`
  - removed the request property `statusMessage`
  - added the new optional request property `allContacts`
  - …4 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/message/sendStatus/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)