List Channels

Endpoint used to list channels of a Slack workspace.

Request Example

curl --request POST \
  --url https://converflow.api.prod.toolzz.media/api/v1/slack/channels \
  --header 'Authorization: Bearer TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --data '{
  "botToken": "string"
}'

Response Example

{
    "data": [
      {
        "id": "<string>",
        "name": "<string>",
        "isPrivate": boolean
      }
    ]
}

---

Request description

Access Token

Parameter	Type	Description	Required
Authorization	String	Access token (“Bearer” must be before the token)	Yes

Body Parameters

Parameter	Type	Description	Required
botToken	String	Slack bot token.	Yes

Response description

Key	Type	Description	Required
data[]	Array	List of objects containing the channels available in the Workspace.	Yes
id	String	Unique channel identifier on Slack.	Yes
name	String	Friendly name of the channel (e.g., “social”, “new-channel”).	Yes
isPrivate	Boolean	Indicates if the channel is private (true) or public (false).	Yes

---

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request. Additionally, the API is protected by other security measures to safeguard user data.

To access your access token, follow these steps:

1. Log in to the ToolzzAI platform
2. Click on “Settings”
3. Click on “Access Token”
4. Copy the access token