Book a demo

List Scheduled Messages

slack.list_scheduled_messages
ActionChat & messagingconnection required

Calls the Slack Web API with the connection's bot token.

List the messages this app has queued but not yet posted.

Ask about SlackAll Slack nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Slack
Secret shape
the Slack bot token (xoxb-…), or {"token": "xoxb-…"}
Resolved by
config.connection_id, else node.connection_id

Configuration

5 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
channel
Only messages queued for this channel id. Omit for every channel.
stringNo———
limit
Maximum queued messages to return on this page (1-1000).
numberNo1001–1000—
cursor
The next_cursor from a previous page.
stringNo———
oldest
Only messages queued to post at or after this Unix timestamp.
stringNo———
latest
Only messages queued to post at or before this Unix timestamp.
stringNo———

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "limit": 100
}

Output

One shape.

result

FieldTypeExample
scheduled_messages[].id
The scheduled message id.
string—
scheduled_messages[].channel_id
Where it will post.
string—
scheduled_messages[].post_at
When it will post (Unix seconds).
number—
scheduled_messages[].date_created
When it was queued.
number—
scheduled_messages[].text
The queued message text.
string—
count
How many queued messages this page carries.
number—
next_cursor
Cursor for the next page, or empty when done.
string—
{
  "count": 0,
  "next_cursor": "",
  "scheduled_messages": [
    {
      "channel_id": "",
      "date_created": 0,
      "id": "",
      "post_at": 0,
      "text": ""
    }
  ]
}

Notes

  • The bot must be a member of a private channel before it can act there (Slack answers not_in_channel otherwise).
  • Slack rate-limits each Web API method on its own tier; a throttled call fails with the number of seconds to wait and is safe for the node's retry policy to repeat.
  • Only messages scheduled through the API appear here, not ones queued in Slack.

Related Slack nodes

Templates that use Slack

Solutions with Slack

See List Scheduled Messages run in a workflow.

In a technical demo we add the Slack connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales