Skip to main content

Slack API Endpoints

The Slack API endpoints the integration uses, with authentication, pagination, and rate-limit details.

This article catalogs the Slack Web API endpoints the iPaaS.com Slack integration calls at runtime. It is intended as a reference for firewall allow-listing, OAuth scope configuration, troubleshooting, and understanding the data flow between iPaaS.com and Slack. Subscribers or their MiSP do not call these endpoints directly; iPaaS.com calls them on the subscriber's behalf when an alert is dispatched.

API Endpoints Intro

Slack exposes a JSON-over-HTTP Web API. The integration uses a single base URL for both the Test and Production environments.

Environment

Base URL

Test

Production

All endpoint paths below are shown relative to this base URL, written as [Base URL]/method.name.

Authentication

The Slack Web API authenticates every request with a bearer token. iPaaS.com supplies the token on the Authorization request header as Bearer <token>.

The token is established during installation by one of two supported methods:

  • OAuth 2.0 (preferred): after saving the subscription, the subscriber authorizes the iPaaS.com Slack app, and Slack returns an access token that iPaaS.com stores. Slack OAuth access tokens do not expire.

  • Bot token (alternative): the subscriber pastes the Slack app's Bot User OAuth Token into the iPaaS.com API Token preset.

In both cases the message-sending and user-lookup requests carry the bearer token. The token grants the chat:write scope (used to post messages) and the users:read scope (used to read the workspace member list). For details on obtaining and storing the token, see the Slack Connections and Settings and Slack Installation Instructions articles linked below.

Table of Contents

  • Message Endpoints

  • User Endpoints

  • Authorization Endpoint

Message Endpoints

Post a Message (POST)

[Base URL]/chat.postMessage

Posts an alert message to the resolved Slack member. iPaaS.com supplies the destination Channel (the resolved member id) and the message Text, formatted as one or more Block Kit section blocks. A long message body is split across blocks and, when split, a follow-up notice is appended.

Slack applies special rate limiting to this method: it generally allows an app to post one message per second to a specific channel, with a workspace-wide ceiling above that of several hundred messages per minute.

User Endpoints

List Users (GET)

[Base URL]/users.list

Retrieves the workspace member list. The integration uses this list to resolve the Channel mapping value — a Slack profile name (Name, then Real Name) — to the underlying Slack member id before posting the message. If no member matches the supplied name, the alert is not delivered to a recipient.

Pagination: users.list returns results using cursor-based pagination. Each response includes a response_metadata.next_cursor value; supplying that value as the cursor argument on a subsequent request, together with a limit, retrieves the next page. Supplying no limit causes Slack to attempt to return the entire member set in one response.

Authorization Endpoint

Exchange the OAuth Code for an Access Token (POST)

[Base URL]/oauth.v2.access

When a subscriber authorizes the iPaaS.com Slack app under the OAuth 2.0 method, iPaaS.com exchanges the authorization code Slack returns for a stored access token using this endpoint. The exchange supplies the client credentials and the redirect URL that iPaaS.com registered for the environment; the subscriber does not enter these values. This endpoint is called only during authorization, not during normal alert dispatch.

Rate Limits and Concurrency

Slack publishes per-method rate limits. The limits relevant to this integration, as documented by Slack (retrieved 26 June 2026), are:

  • chat.postMessage: special rate limiting — generally one message per second to a specific channel, with a workspace-wide ceiling of several hundred messages per minute.

  • users.list: Tier 2 — 20+ requests per minute.

  • oauth.v2.access: 600 requests per minute.

Independently of Slack's limits, the subscription carries an API Throttle Limit / Concurrent Batch Executions setting that governs how many batches iPaaS.com runs at once (Initial 5, Ongoing 500). Subscribers or their MiSP should keep this in mind when dispatching high volumes of alerts so that Slack's per-channel limit is not exceeded.

Related Documents

Did this answer your question?