Slack APIerrors

Slack API errorsand how to fix them.

When Slack rejects a request, Siar stores the network's own code and message on the post and returns it to you unchanged, so what you read here matches what you see in the API. Back to the Slack API.

Where a code is shown it is the network's own code or HTTP status. Messages are abridged where Slack's text is long.

not_in_channel

Message
not_in_channel

What it means. The app is not a member of the channel (always the case for private channels, and for public ones without chat:write.public).

How to fix it. Invite the app in Slack: /invite @Siar in the channel.

channel_not_found

Message
channel_not_found

What it means. The channel does not exist or is private and the app was not invited.

How to fix it. Refresh channels and pick again, or invite the app to the private channel.

is_archived

Message
is_archived

What it means. The channel was archived.

How to fix it. Unarchive it or choose another channel.

invalid_auth

Message
invalid_auth

What it means. The bot token is invalid, revoked or the app was uninstalled.

How to fix it. Reconnect the Slack workspace.

token_revoked

Message
token_revoked

What it means. A workspace admin removed the app or revoked its token.

How to fix it. Reconnect the Slack workspace.

missing_scope

Message
missing_scope (needs chat:write.customize)

What it means. A feature (custom username/icon, reactions, private channel history) needs a scope the install does not have.

How to fix it. Reconnect to grant the new scopes.

msg_too_long

Message
msg_too_long

What it means. The text is over Slack's 40,000 character limit.

How to fix it. Shorten the text.

cant_delete_message

Message
cant_delete_message

What it means. The app may only delete its own messages, and the workspace may restrict deletion.

How to fix it. Delete it in Slack as a member with permission.

edit_window_closed

Message
edit_window_closed

What it means. The workspace limits how long a message can be edited.

How to fix it. Post a new message instead.

ratelimited

Message
ratelimited

What it means. chat.postMessage allows about 1 message per second per channel; Retry-After says when.

How to fix it. Retry after the delay (Siar does).

Where to see an error

Read a failed post with GET /post/{id}: the error field summarises it, errors lists it per network and errorsVerbose keeps the detail. A post.published webhook fires when the post reaches a final state. Retry with POST /post/{id}/retry. Limits that Siar enforces itself are on the Slack page.

Your first post isone request away.

The Free plan includes 20 posts and 200 uploads a month across 3 teams. No card needed.