---
title: "Changes to Envia mensagem WhatsApp (template, texto, interativa, localização ou reação)"
method: POST
path: "/v1/messages"
---

# Changes to Envia mensagem WhatsApp (template, texto, interativa, localização ou reação)

`POST /v1/messages`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 4 revisions.

- **2026-07-15** `174c89e36a13` — 1 breaking, 8 warning, 1 info
- **2026-05-25** `4e426b85f784` — 4 breaking, 2 warning, 25 info

## Changes

- **2026-07-15** `174c89e36a13` — 1 breaking, 8 warning, 1 info
  - removed the enum value `TEST` of the request property `mode`
  - added the new `CANCELED` enum value to the `status` response property for the response status `202`
  - added the new `DELIVERED` enum value to the `status` response property for the response status `202`
  - added the new `FAILED` enum value to the `status` response property for the response status `202`
  - added the new `PENDING` enum value to the `status` response property for the response status `202`
  - added the new `PROCESSING` enum value to the `status` response property for the response status `202`
  - added the new `READ` enum value to the `status` response property for the response status `202`
  - added the new `SCHEDULED` enum value to the `status` response property for the response status `202`
  - added the new `SENT` enum value to the `status` response property for the response status `202`
  - removed the `TEST` enum value from the `mode` response property for the response status `202`
- **2026-05-25** `4e426b85f784` — 4 breaking, 2 warning, 25 info
  - the response property `body` became nullable for the status `202`
  - the response property `cost` became nullable for the status `202`
  - the response property `id` became nullable for the status `202`
  - the `cost` response's property type/format changed from `number`/`decimal` to `number`/`float` for status `202`
  - deleted the `header` request parameter `Idempotency-Key`
  - removed the request property `channel`
  - api tag `messages` added
  - api tag `Messages` removed
  - added the new optional request property `interactive`
  - added the new optional request property `location`
  - added the new optional request property `media_url`
  - added the new optional request property `reaction`
  - added the new optional request property `replyTo`
  - added the new optional request property `sender`
  - added the new optional request property `type`
  - the request property `body` became nullable
  - the request property `mode` became nullable
  - the request property `scheduled_at` became nullable
  - the request property `smartLinkParam` became nullable
  - the request property `smartLinkUrl` became nullable
  - the request property `templateName` became nullable
  - the request property `templateVariables` became nullable
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the non-success response with the status `422`
  - added the non-success response with the status `429`
  - the response property `mode` became required for the status `202`
  - the response property `receiver` became required for the status `202`
  - the response property `sender` became required for the status `202`
  - the response property `status` became required for the status `202`

---

[Operation](https://skmtc.dev/ararahq/apis/ararahq-api/docs/v1/messages/post.md) · [API](https://skmtc.dev/ararahq/apis/ararahq-api.md) · [Page](https://skmtc.dev/ararahq/apis/ararahq-api/changes/v1/messages/post)
