---
title: "POST /chat.scheduleMessage"
method: POST
path: "/chat.scheduleMessage"
tags: ["chat"]
---

# POST /chat.scheduleMessage

`POST /chat.scheduleMessage`

Schedules a message to be sent to a channel.

## Headers

- `token` string

## Response `200`

Typical success response

- object — Schema for successful response of chat.scheduleMessage method
  - `channel` string, required
  - `message` object, required
    - `bot_id` string, required
    - `bot_profile` ObjsBotProfile
      - `app_id` string, required
      - `deleted` boolean, required
      - `icons` object, required
        - `image_36` string, uri, required
        - `image_48` string, uri, required
        - `image_72` string, uri, required
      - `id` string, required
      - `name` string, required
      - `team_id` string, required
      - `updated` integer, required
    - `team` string, required
    - `text` string, required
    - `type` string, required
    - `user` string, required
    - `username` string
  - `ok` true, required
  - `post_at` integer, required
  - `scheduled_message_id` string, required

## Other responses

- `default` — Typical error response if the `post_at` is invalid (ex. in the past or too far into the future)

---

[API](https://skmtc.net/slack/apis/web-api.md) · [All operations](https://skmtc.net/slack/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slack/web-api/versions/7b951462b44f/schema)