---
title: "Changes to Send a message"
method: POST
path: "/send"
---

# Changes to Send a message

`POST /send`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 55 revisions.

- **2026-08-10** `cb8586034158`: 1 breaking, 1 info
- **2026-07-29** `f76bed79a913`: 2 info
- **2026-07-20** `d2377425a729`: 1 breaking, 1 info
- **2026-04-02** `b3dde9374868`: 1 info
- **2026-03-04** `44c2e612f5d4`: 1 warning
- **2026-02-06** `3fc1c86b4a83`: 1 breaking, 1 info
- **2026-01-14** `e3e54d99e2a7`: 1 info
- **2026-01-05** `361d17797dff`: 1 breaking, 1 info
- **2025-12-16** `9859cb664d1a`: 1 info
- **2025-11-09** `33d5d7c18097`: 2 info
- **2025-10-17** `e67d02739533`: 2 info
- **2025-10-10** `1cc4508dc9f8`: 19 breaking, 2 warning
- **2025-10-07** `19a2edb4822c`: 2 info
- **2025-10-07** `0925361b8122`: 1 info
- **2025-10-07** `7143ea51f307`: 6 breaking, 3 info

## Changes

- **2026-08-10** `cb8586034158`: 1 breaking, 1 info
  - removed `subschema #1, subschema #3, subschema #7` from the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
  - added `subschema #1, subschema #3, subschema #7` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
- **2026-07-29** `f76bed79a913`: 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2026-07-20** `d2377425a729`: 1 breaking, 1 info
  - removed `subschema #4, subschema #5` from the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
  - added `subschema #4, subschema #5` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
- **2026-04-02** `b3dde9374868`: 1 info
  - added `subschema #8` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
- **2026-03-04** `44c2e612f5d4`: 1 warning
  - removed the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/brand`
- **2026-02-06** `3fc1c86b4a83`: 1 breaking, 1 info
  - removed `#/components/schemas/UserRecipient, #/components/schemas/AudienceRecipient, #/components/schemas/ListRecipient, #/components/schemas/ListPatternRecipient, #/components/schemas/SlackRecipient, #/components/schemas/MsTeamsRecipient, #/components/schemas/PagerdutyRecipient, #/components/schemas/WebhookRecipient` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to` request property `oneOf` list
  - added `#/components/schemas/Recipient, subschema #2` to the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to` request property `oneOf` list
- **2026-01-14** `e3e54d99e2a7`: 1 info
  - the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #3]/allOf[subschema #2: ElementalChannelNode]/channel` became optional
- **2026-01-05** `361d17797dff`: 1 breaking, 1 info
  - removed `#/components/schemas/Recipient, subschema #2` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to` request property `oneOf` list
  - added `#/components/schemas/UserRecipient, #/components/schemas/AudienceRecipient, #/components/schemas/ListRecipient, #/components/schemas/ListPatternRecipient, #/components/schemas/SlackRecipient, #/components/schemas/MsTeamsRecipient, #/components/schemas/PagerdutyRecipient, #/components/schemas/WebhookRecipient` to the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to` request property `oneOf` list
- **2025-12-16** `9859cb664d1a`: 1 info
  - added the new optional request property `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #1: BaseMessage]/delay/timezone`
- **2025-11-09** `33d5d7c18097`: 2 info
  - added the new optional request property `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #1: Recipient]/oneOf[subschema #1: UserRecipient]/list_id`
  - added the new optional request property `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #2]/items/oneOf[subschema #1: UserRecipient]/list_id`
- **2025-10-17** `e67d02739533`: 2 info
  - api tag `Send` added
  - api tag `` removed
- **2025-10-10** `1cc4508dc9f8`: 19 breaking, 2 warning
  - added `#/components/schemas/ElementalBaseNode` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/` request property `allOf` list
  - added `#/components/schemas/IActionButtonStyle` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/style` request property `allOf` list
  - added `#/components/schemas/IAlignment` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align` request property `allOf` list
  - added `#/components/schemas/Locales` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/locales` request property `allOf` list
  - the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/locales` became not nullable
  - the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/content` became required
  - the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/href` became required
  - the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/locales` became required
  - removed the enum value `button` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/style`
  - removed the enum value `center` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align`
  - removed the enum value `full` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align`
  - removed the enum value `left` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align`
  - removed the enum value `link` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/style`
  - removed the enum value `right` of the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align`
  - removed `#/components/schemas/ListRecipient` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #1: Recipient]/` request property `oneOf` list
  - removed `#/components/schemas/ListRecipient` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #2]/items/` request property `oneOf` list
  - the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/align` request property type changed from `string` to no type
  - the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/locales` request property type changed from `object` to no type
  - the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/style` request property type changed from `string` to no type
  - removed the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/allOf`
  - removed the request property `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #2: ElementalContent]/elements/items/oneOf[subschema #5]/allOf[subschema #2: ElementalActionNode]/required`
- **2025-10-07** `19a2edb4822c`: 2 info
  - added `#/components/schemas/ListRecipient` to the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #1: Recipient]/` request property `oneOf` list
  - added `#/components/schemas/ListRecipient` to the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #2]/items/` request property `oneOf` list
- **2025-10-07** `0925361b8122`: 1 info
  - added the new optional request property `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #1: BaseMessage]/template`
- **2025-10-07** `7143ea51f307`: 6 breaking, 3 info
  - removed `#/components/schemas/AudienceRecipient, #/components/schemas/ListRecipient, #/components/schemas/ListPatternRecipient, #/components/schemas/SlackRecipient, #/components/schemas/MsTeamsRecipient, #/components/schemas/RecipientData, #/components/schemas/PagerdutyRecipient, #/components/schemas/WebhookRecipient` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #1: Recipient]/` request property `oneOf` list
  - removed `#/components/schemas/AudienceRecipient, #/components/schemas/ListRecipient, #/components/schemas/ListPatternRecipient, #/components/schemas/SlackRecipient, #/components/schemas/MsTeamsRecipient, #/components/schemas/RecipientData, #/components/schemas/PagerdutyRecipient, #/components/schemas/WebhookRecipient` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #2: BaseMessageSendTo]/to/oneOf[subschema #2]/items/` request property `oneOf` list
  - removed `#/components/schemas/RoutingStrategyChannel, #/components/schemas/RoutingStrategyProvider` from the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #1: BaseMessage]/routing/channels/items/` request property `oneOf` list
  - removed `#/components/schemas/TemplateMessage` from the `message` request property `oneOf` list
  - removed `subschema #3, subschema #5, subschema #7` from the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #1: ElementalContent -> subschema #2: ElementalContent]/elements/items/` request property `oneOf` list
  - the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #1: ElementalContent -> subschema #2: ElementalContent]/brand` request property type changed from no type to `string`
  - the request property `message/oneOf[subschema #1: ContentMessage]/content` became optional
  - added `#/components/schemas/MessageRouting` to the `message/oneOf[subschema #1: ContentMessage]/allOf[subschema #1: BaseMessage]/routing/channels/items/` request property `oneOf` list
  - added `subschema #3, subschema #5` to the `message/oneOf[subschema #1: ContentMessage]/content/oneOf[subschema #1: ElementalContent -> subschema #2: ElementalContent]/elements/items/` request property `oneOf` list

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/send/post.md) - [API](https://skmtc.dev/trycourier/apis/courier.md) - [Page](https://skmtc.dev/trycourier/apis/courier/changes/send/post)
