Slack

Connect a Slack channel

Finalize a Slack connect by creating the per-channel account. Served by a dedicated route, so it is not reachable through POST /v1/connect/{platform}. Send pendingDataToken for a first connect (the nonce from the OAuth redirect) or accountId to add another channel to a workspace already connected.

Billing: Request; paid actions are priced in credits (see GET /v1/messaging/prices) · Rate limit: 60/min

post/v1/messaging/connect/slack

Request

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

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=…

Request body

accountIdstring

Existing Slack account whose workspace token is reused. Required unless pendingDataToken is sent.

channelIdstring

Slack channel id, C... or G.... Send this or channelIds, not both.

channelIdsstring[]

Several channels of the workspace to connect, each as its own account. With two or more distinct ids the response lists accounts and failed instead of account, and the request is refused with 400 on a reconnect. A single id behaves exactly like channelId.

redirect_urlstring

channelIds only: a URL to return in redirect_url, with connected, profileId, accountId and accountIds appended.

pendingDataTokenstring

Nonce from the OAuth redirect. Required unless accountId is sent.

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
outputobject

Operation result (see each operation). While a Studio render is processing: stage (queued · transcribing · downloading · preparing · cleaning_voice · mixing_audio · rendering · finishing), phase (the engine's: download · prepare · voice · audio · encode · qa · upload, or null), progress (a percent, 0–100) and progress_fraction (0–1), eta_seconds (seconds left, never below 0) and estimate_seconds

errorstring nullable

Changes

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