List Pinned Items

slack.list_pins

ActionChat & messagingconnection required

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

List everything pinned in a channel — messages and files alike.

Ask about Slack All Slack nodes Provider 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

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

Field	Type	Required	Default	Constraints	Example
channel Channel id holding the message (C…, G… or D…). Supports {{ }}.	string	Yes	—	—	—

Output

One shape.

result

Field	Type	Example
channel The channel whose pins were read.	string	—
items[].type message, file or file_comment.	string	—
items[].created When the item was pinned (Unix seconds).	number	—
items[].created_by The user id that pinned it.	string	—
items[].ts The message ts, for a pinned message.	string	—
items[].text The message text, for a pinned message.	string	—
items[].file_id The file id, for a pinned file.	string	—
count How many items are pinned in the channel.	number	—

{
  "channel": "",
  "count": 0,
  "items": [
    {
      "created": 0,
      "created_by": "",
      "file_id": "",
      "text": "",
      "ts": "",
      "type": ""
    }
  ]
}

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.

Related Slack nodes

Templates that use Slack

Solutions with Slack

See List Pinned Items 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 demo Talk to sales