Connect

Connect a Slack channel

Changed on

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.

post/v1/connect/slack

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/connect/slack
  • Auth: HTTP bearer

Request body

profileIdstring required
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.

accountIdstring

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

Response

Channel connected

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status