---
title: "Changes to Schedule an announcement"
method: POST
path: "/v3/announcements"
---

# Changes to Schedule an announcement

`POST /v3/announcements`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 36 revisions.

- **2025-07-27** `7a85bad03e90`: 3 breaking, 11 warning, 24 info
- **2023-11-10** `135d8b0705d4`: 1 info
- **2022-10-25** `f602ae6767eb`: 1 breaking, 3 warning, 8 info
- **2022-06-29** `4012275aa67d`: 2 info
- **2022-02-16** `c42164095c7c`: 1 breaking

## Changes

- **2025-07-27** `7a85bad03e90`: 3 breaking, 11 warning, 24 info
  - the `create_channel_options` request property type changed from `string` to `object`
  - the `end_at` request property format changed from no format to `int64`
  - the `scheduled_at` request property format changed from no format to `int64`
  - deleted the `header` request parameter `Api-Token`
  - removed the request property `content`
  - removed the request property `create_channel_options.cover_url`
  - removed the request property `create_channel_options.custom_type`
  - removed the request property `create_channel_options.data`
  - removed the request property `create_channel_options.distinct`
  - removed the request property `create_channel_options.name`
  - removed the request property `message.custom_type`
  - removed the request property `message.data`
  - removed the request property `message_type`
  - removed the request property `user_id`
  - api operation id `scheduleAnnouncement` removed and replaced with `scheduleAnAnnouncement`
  - added the new optional `header` request parameter `api-token`
  - added the new optional request property `create_channel_options/cover_url`
  - added the new optional request property `create_channel_options/custom_type`
  - added the new optional request property `create_channel_options/data`
  - added the new optional request property `create_channel_options/distinct`
  - added the new optional request property `create_channel_options/name`
  - added the new optional request property `keep_channel_hidden_for_sender`
  - added the new optional request property `mark_as_read`
  - added the new optional request property `message/custom_type`
  - added the new optional request property `message/data`
  - added the new optional request property `send_to_frozen_channels`
  - added the new optional request property `target_custom_type`
  - the request property `message` became optional
  - the request property `target_at` became optional
  - the request property `target_channel_type` became optional
  - the request property `target_list` became optional
  - added the optional property `create_channel` to the response with the `200` status
  - added the optional property `end_at` to the response with the `200` status
  - added the optional property `mark_as_read` to the response with the `200` status
  - added the optional property `message/message_retention_hour` to the response with the `200` status
  - added the optional property `priority` to the response with the `200` status
  - added the optional property `send_to_frozen_channels` to the response with the `200` status
  - added the optional property `target_custom_type` to the response with the `200` status
- **2023-11-10** `135d8b0705d4`: 1 info
  - the `header` request parameter `Api-Token` became optional
- **2022-10-25** `f602ae6767eb`: 1 breaking, 3 warning, 8 info
  - the `message` request property type changed from `string` to `object`
  - removed the request property `message.content`
  - removed the request property `message.type`
  - removed the request property `message.user_id`
  - api tag `Announcement` added
  - api tag `Message` removed
  - added the new optional request property `content`
  - added the new optional request property `message/content`
  - added the new optional request property `message/type`
  - added the new optional request property `message/user_id`
  - added the new optional request property `message_type`
  - added the new optional request property `user_id`
- **2022-06-29** `4012275aa67d`: 2 info
  - api tag `Message` added
  - api tag `Announcements` removed
- **2022-02-16** `c42164095c7c`: 1 breaking
  - the `header` request parameter `Api-Token` became required

---

[Operation](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/docs/v3/announcements/post.md) - [API](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk.md) - [Page](https://skmtc.dev/sendbird/apis/sendbird-platform-sdk/changes/v3/announcements/post)