Guide - Qordinate | Slack

Is Slack giving you a headache?

You were probably searching for a fix for that obscure Slack error. But maybe you found something better.

Stop debugging. Start coordinating.

Qordinate acts as your intelligent layer between apps like Slack and your life. We handle the messy API connections and coordination so you can focus on what actually matters.

Slack Integration Terminal Errors

Authentication Errors

invalid_auth

Error: invalid_auth
{"ok":false,"error":"invalid_auth"}

Occurs when bot token is expired, revoked, or malformed. Terminal output shows HTTP 200 with error payload.

not_authed

Error: not_authed
{"ok":false,"error":"not_authed","response_metadata":{}}

API call made without authentication token or token missing from request headers.

account_inactive

Error: account_inactive
{"ok":false,"error":"account_inactive"}

Bot user account has been deactivated or workspace access revoked.

token_expired

SlackApiError: token_expired
    at SlackClient.postMessage (/node_modules/@slack/web-api/dist/WebClient.js:123:45)

OAuth access token expired. Refresh token required for renewal.

missing_scope

Error: missing_scope
{"ok":false,"error":"missing_scope","needed":"channels:read","provided":["chat:write"]}

Bot token lacks required OAuth scope. Terminal shows needed and provided scopes in error response.

Rate Limiting Errors

rate_limited

Error: rate_limited
HTTP 429 Too Many Requests
Retry-After: 60
{"ok":false,"error":"rate_limited","retry_after":60}

Rate limit exceeded. Check Retry-After header value for seconds to wait.

ratelimited

SlackApiError: ratelimited
    at handlePlatformError (/slack-sdk/dist/errors.js:89:12)

SDK throws exception when rate limit hit. Requires exponential backoff implementation.

API Request Errors

invalid_arguments

Error: invalid_arguments
{"ok":false,"error":"invalid_arguments","response_metadata":{"messages":["[ERROR] missing required field: channel"]}}

Request missing required parameters. Terminal shows specific missing fields in messages array.

channel_not_found

Error: channel_not_found
{"ok":false,"error":"channel_not_found"}

Channel ID or name doesn't exist or bot lacks access.

not_in_channel

Error: not_in_channel
{"ok":false,"error":"not_in_channel"}

Bot not member of channel. Must join channel before posting messages.

message_too_long

Error: message_too_long
{"ok":false,"error":"message_too_long"}

Message text exceeds 4000 character limit for chat.postMessage.

invalid_blocks

Error: invalid_blocks
{"ok":false,"error":"invalid_blocks","response_metadata":{"messages":["[ERROR] blocks[0].type must be one of: section, divider, image, actions, context, input, file, header, video, rich_text"]}}

Block Kit JSON structure invalid. Terminal shows specific validation errors.

Webhook & Events API Errors

invalid_request

Error: invalid_request
HTTP 400 Bad Request
{"error":"invalid_request","error_description":"The request is missing a required parameter"}

Webhook request missing required parameters like token, team_id, or api_app_id.

invalid_signature

Error: invalid_signature
HTTP 401 Unauthorized
X-Slack-Signature: v0=abc123...

Webhook signature verification failed. Timestamp skew or incorrect signing secret.

challenge_failed

Error: challenge_failed
{"challenge":"3eZbrw1aBd2rqRg0TbGCM6","type":"url_verification"}

Events API URL verification challenge response incorrect or missing.

SDK-Specific Errors

Python SDK: slack.errors.SlackApiError

Traceback (most recent call last):
  File "slack_bot.py", line 45, in <module>
    response = client.chat_postMessage(channel="#general", text="Hello")
  File "/venv/lib/python3.9/site-packages/slack/web/client.py", line 234, in chat_postMessage
    raise SlackApiError(message=error, response=response)
slack.errors.SlackApiError: The request to the Slack API failed.
The server responded with: {'ok': False, 'error': 'invalid_auth'}

Node.js SDK: Error [SlackAPIError]

Error [SlackAPIError]: An API error occurred: invalid_auth
    at WebClient.apiCall (/node_modules/@slack/web-api/dist/WebClient.js:185:25)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)

Ruby SDK: Slack::Web::Api::Errors::SlackError

Slack::Web::Api::Errors::SlackError: invalid_auth
  from /gems/slack-ruby-client-2.0.0/lib/slack/web/api/endpoints/chat.rb:45:in `postMessage'

Go SDK: slack.SlackError

slack.SlackError: invalid_auth
    slack.(*Client).PostMessage(0xc0000a2000, 0xc0000b4000, 0x1234567)
        /go/pkg/mod/github.com/slack-go/slack@v0.12.0/chat.go:89

WebSocket & RTM Errors

invalid_auth (RTM)

Error: invalid_auth
{"ok":false,"error":"invalid_auth","url":""}

RTM WebSocket connection fails authentication. No url returned in response.

connection_closed

Error: connection_closed
WebSocket connection closed unexpectedly

RTM WebSocket disconnects without close frame. Requires reconnection logic.

socket_mode_connection_failed

Error: socket_mode_connection_failed
Failed to establish Socket Mode WebSocket connection

Socket Mode WebSocket fails to connect. Check app-level token validity.

File Upload Errors

file_too_large

Error: file_too_large
{"ok":false,"error":"file_too_large","max_size_bytes":1048576000}

File exceeds 1GB upload limit. Terminal shows max_size_bytes in error response.

invalid_file_type

Error: invalid_file_type
{"ok":false,"error":"invalid_file_type"}

File type not supported for upload. Check allowed MIME types.

file_deleted

Error: file_deleted
{"ok":false,"error":"file_deleted"}

File referenced by ID has been deleted from workspace.

Pagination Errors

invalid_cursor

Error: invalid_cursor
{"ok":false,"error":"invalid_cursor"}

Pagination cursor expired or malformed. Cursors expire after 5 minutes.

cursor_pagination_failed

Error: cursor_pagination_failed
{"ok":false,"error":"cursor_pagination_failed","response_metadata":{"next_cursor":""}}

Pagination request fails. next_cursor empty string indicates no more pages.

Interactive Components Errors

action_not_found

Error: action_not_found
{"ok":false,"error":"action_not_found"}

Interactive component action handler not registered or callback ID mismatch.

interactive_timeout

Error: interactive_timeout
{"ok":false,"error":"interactive_timeout"}

Interactive component response not sent within 3-second window.

invalid_trigger_id

Error: invalid_trigger_id
{"ok":false,"error":"invalid_trigger_id"}

Modal or interactive component trigger_id expired or already used.

Workspace & Team Errors

team_added_to_org

Error: team_added_to_org
{"ok":false,"error":"team_added_to_org"}

Workspace added to Enterprise Grid organization. API behavior changes.

restricted_action

Error: restricted_action
{"ok":false,"error":"restricted_action"}

Action restricted by workspace admin settings or Enterprise Grid policies.

enterprise_is_restricted

Error: enterprise_is_restricted
{"ok":false,"error":"enterprise_is_restricted"}

Enterprise Grid restriction prevents API call execution.

OAuth Flow Errors

invalid_client_id

Error: invalid_client_id
{"ok":false,"error":"invalid_client_id"}

OAuth client ID incorrect or app not found.

invalid_code

Error: invalid_code
{"ok":false,"error":"invalid_code"}

OAuth authorization code expired, already used, or invalid.

invalid_redirect_uri

Error: invalid_redirect_uri
{"ok":false,"error":"invalid_redirect_uri"}

OAuth redirect URI doesn't match registered redirect URLs in app settings.

Connection & Network Errors

request_timeout

Error: request_timeout
TimeoutError: Request timed out after 30000ms
    at Timeout._onTimeout (/node_modules/axios/lib/adapters/http.js:201:15)

API request exceeds 30-second timeout. Network congestion or Slack service degradation.

network_error

Error: network_error
FetchError: request to https://api.slack.com/api/chat.postMessage failed, reason: getaddrinfo ENOTFOUND api.slack.com

DNS resolution failure or network connectivity issue.

ssl_handshake_failed

Error: ssl_handshake_failed
Error: SSL handshake failed: unable to verify the first certificate
    at TLSSocket.onConnectSecure (_tls_wrap.js:1515:34)

SSL/TLS certificate validation failure. Corporate proxy or certificate chain issues.

Webhook Delivery Errors

webhook_timeout

Error: webhook_timeout
HTTP 504 Gateway Timeout
X-Slack-Retry-Num: 3

Webhook endpoint timeout after retry attempts. Check X-Slack-Retry-Num header.

webhook_delivery_failed

Error: webhook_delivery_failed
{"ok":false,"error":"webhook_delivery_failed","retry_after":300}

Webhook delivery failed after maximum retries. Manual event replay required.

Miscellaneous Errors

method_deprecated

Error: method_deprecated
{"ok":false,"error":"method_deprecated","response_metadata":{"warnings":["method_deprecated"]}}

API method deprecated. Migration to newer API version required.

internal_error

Error: internal_error
{"ok":false,"error":"internal_error"}

Slack server-side error. Retry request after delay.

service_unavailable

Error: service_unavailable
HTTP 503 Service Unavailable
{"ok":false,"error":"service_unavailable"}

Slack service temporarily unavailable. Check status page.

fatal_error

Error: fatal_error
{"ok":false,"error":"fatal_error"}

Critical error preventing request processing. Contact Slack support.