Slack

List Slack channels for the channel picker

Serves the channel picker of the Slack connect flow. Slack's OAuth installs the bot into a workspace, not a channel, so after the redirect the caller lists the workspace's channels here and finalizes one with POST /v1/connect/slack. Served by a dedicated route that shadows GET /v1/connect/{platform} for slack.

Send exactly one of pendingDataToken (first connect: the nonce from the OAuth redirect, bound to the same profileId) or accountId (add another channel to a workspace already connected: the existing Slack account's workspace token is reused, no re-OAuth). With neither, the endpoint behaves like GET /v1/connect/{platform} and returns authUrl and state to start the OAuth flow.

Channels are read live from Slack (conversations.list, public and private, archived excluded, up to 2,000). isMember says whether the Zernio bot is already in the channel: a public channel is joined automatically on finalize, a private one must be invited (/invite @Zernio) first.

Billing: Read (free unless it says otherwise) · Rate limit: 120/min

get/v1/messaging/connect/slack

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/connect/slack
  • Auth: HTTP bearer

Query parameters

scopesstring

Start-OAuth mode only. Comma-separated permission areas to request instead of the full Slack scope set, with the same semantics as scopes on GET /v1/connect/{platform}: posting installs the bot with the channel scopes it needs to post, messaging adds the history, DM and reaction scopes the inbox reads; analytics, comments and ads add nothing on Slack. Omit it to request everything.

accountIdstring

Existing active Slack account (yours or a team member's) whose workspace token is reused.

redirect_urlstring uri

Start-OAuth mode only: where to send the user after the connect completes. redirectUrl is accepted as an alias.

pendingDataTokenstring

Nonce from the OAuth redirect (first connect).

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Response

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.