---
title: Slack
slug: connectors/slack
docTags: 
createdAt: 2026-06-09T16:30:29.905Z
---

Slack is a cloud-based messaging and collaboration platform that enables teams to communicate, share files, and integrate with other tools in real time.

Slack is a leading collaboration and messaging platform that enables real-time communication and information sharing across teams. The Slack connector for Swimlane Turbine allows users to automate channel management, message broadcasting, user administration, and information retrieval directly within their security workflows. By integrating Slack with Swimlane Turbine, security teams can streamline incident response, enhance collaboration, and ensure timely notifications and actions without manual intervention. This integration empowers users to orchestrate communication, manage channels and users, and automate critical security operations, all from a single low-code platform.

## Prerequisites

Before you can use the Slack connector, ensure you have the following prerequisites:

- API Key authentication using these parameters:
  - URL: The base URL for Slack's API endpoints (typically [https://slack.com/api/](https://slack.com/api/))
  - API Key: A valid Slack API key or token with appropriate permissions for your intended actions
- HTTP Bearer Token authentication using these parameters:
  - URL: The base URL for Slack's API endpoints (typically [https://slack.com/api/](https://slack.com/api/))
  - Token: A bearer token (such as a JWT or OAuth access token) authorized for Slack API access

## Capabilities

The Slack Connector has the following capabilities:

- Create, archive, and retrieve history of conversations
- Get Message Permalink
- Invite and remove users from a conversation
- Retrieve current users in a conversation
- Send broadcast messages
- Lookup by Email

## Asset Setup

The asset for this connector requires the following inputs:

- API Token - Bot or User Token

To set up a Slack Bot OAUTH API with the appropriate permissions follow these steps:

- Go to the Slack API website: [https://api.slack.com/](https://api.slack.com/).
- Click on "Your Apps" in the top-right corner and then click on "Create New App."
- Provide a name for your app and select the Slack workspace where you want to install the app.
- Once the app is created, you'll be redirected to the app's settings page.
- From the app's settings page, navigate to "OAuth & Permissions".
- Under the "Scopes" section for "Bot Token Scopes", add the necessary scopes for the API calls:
- chat✍️ This scope allows your app to send messages to channels and conversations.
- channels🏛️ This scope grants access to conversation history in public channels.
- channels🈴 This scope allows your app to invite users to public channels.
- channels\:manage: This scope grants the ability to manage public channels, including archiving, inviting, and kicking users.
- channels📕 This scope provides access to channel and conversation information.
- chat\:write.customize: This scope allows your app to customize messages with blocks and attachments.
- groups✍️ This scope allows your app to create new channels
- groups🏛️ This scope grants access to conversation history in private channels.
- groups📕 This scope provides access to private channel information.
- im🏛️ This scope grants access to conversation history in direct messages.
- mpim🏛️ This scope allows your app to view messages and other content in group direct messages that your Slack app has been added to.
- im📕 This scope provides access to direct message channel information.
- users📕 This scope allows your app to retrieve user information.
  *... and so on*

### Install the app to your workspace:

- In the app's settings page, go to "OAuth & Permissions".
- Scroll down to the "OAuth Tokens for Your Workspace" section and click on the "Install App to Workspace" button.
- Authorize the app to access your Slack workspace by following the prompts.

### Obtain your access tokens:

- After installing the app, you'll be provided with access tokens such as "Bot User OAuth Access Token".

## Notes

- [Slack API Documentation or Methods Link](https://api.slack.com/methods)

See the following topics for more about User and Bot OAuth Tokens:

- [Token Types](https://api.slack.com/authentication/token-types)
- [Scopes](https://api.slack.com/scopes)
- [Web API](https://api.slack.com/web)

This connector was last tested against product version: 4.12.0

## Additional Notes

- For **LookUp by Email** action, please set the **scope** parameter to **users\:read.email** .

# Configurations

## API Key Authentication

Authenticates using an API Key

### Configuration Parameters

| **Parameter** | **Description**                    | **Type** | **Required** |
| ------------- | ---------------------------------- | -------- | ------------ |
| url           | A URL to the target host.          | string   | Required     |
| token         | API key                            | string   | Required     |
| verify\_ssl   | Verify SSL certificate             | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through. | string   | Optional     |

## HTTP Bearer Authentication

Authenticates using bearer token such as a JWT, etc.

### Configuration Parameters

| **Parameter** | **Description**                    | **Type** | **Required** |
| ------------- | ---------------------------------- | -------- | ------------ |
| url           | A URL to the target host.          | string   | Required     |
| token         | The API key, token, etc.           | string   | Required     |
| verify\_ssl   | Verify SSL certificate             | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through. | string   | Optional     |

# Actions

## Broadcast Message

Post a message to a Slack channel or reply in a thread by specifying the channel ID and, optionally, the parent message timestamp.

### Endpoint

- **URL:** `api/chat.postMessage/`
- **Method:** `POST`

### Input

| **Argument Name**               | **Type** | **Required** | **Description**                                                     |
| ------------------------------- | -------- | ------------ | ------------------------------------------------------------------- |
| `channel`                       | string   | Required     | The channel to send the message to. To use the channel name, use /# |
| `title`                         | string   | Optional     | Parameter for Broadcast Message                                     |
| `reply_broadcast`               | string   | Optional     | Parameter for Broadcast Message                                     |
| `mrkdwn`                        | string   | Optional     | Parameter for Broadcast Message                                     |
| `username`                      | string   | Optional     | Name of the resource                                                |
| `markdown_text`                 | string   | Optional     | Parameter for Broadcast Message                                     |
| `parse`                         | string   | Optional     | Parameter for Broadcast Message                                     |
| `current_draft_last_updated_ts` | string   | Optional     | Parameter for Broadcast Message                                     |
| `link_names`                    | string   | Optional     | Name of the resource                                                |
| `text`                          | string   | Optional     | Parameter for Broadcast Message                                     |
| `thread_ts`                     | string   | Optional     | Parameter for Broadcast Message                                     |
| `unfurl_links`                  | string   | Optional     | URL endpoint for the request                                        |
| `unfurl_media`                  | string   | Optional     | URL endpoint for the request                                        |
| `metadata`                      | object   | Optional     | Response data                                                       |
| `icon_url`                      | string   | Optional     | URL endpoint for the request                                        |
| `icon_emoji`                    | string   | Optional     | Parameter for Broadcast Message                                     |
| `blocks`                        | array    | Optional     | Parameter for Broadcast Message                                     |
| `blocks.type`                   | string   | Optional     | Type of the resource                                                |
| `blocks.text`                   | object   | Optional     | Parameter for Broadcast Message                                     |
| `blocks.text.type`              | string   | Optional     | Type of the resource                                                |
| `blocks.text.text`              | string   | Optional     | Parameter for Broadcast Message                                     |
| `blocks.fields`                 | array    | Optional     | Parameter for Broadcast Message                                     |
| `blocks.fields.type`            | string   | Optional     | Type of the resource                                                |
| `blocks.fields.text`            | string   | Optional     | Parameter for Broadcast Message                                     |
| `blocks.elements`               | array    | Optional     | Parameter for Broadcast Message                                     |

### Input Example

`{"channel":"C04J0U2RUMT","metadata":{},"blocks":[{"type":"section","text":{"type":"mrkdwn","text":"SOC Alert: *<https://soc.dev.services.us-east-1.aws.swimlane.io/integration%7CSwimlane SOC - New device request>*"}},{"type":"section","fields":[{"type":"mrkdwn","text":"*Who:*\nrene.vanzijl@swimlane.com"},{"type":"mrkdwn","text":"*What:* Review user activity. Rene van Zijl performed login activity from a rarely observed country (Spain)"},{"type":"mrkdwn","text":"*When:*\n2022-08-07T09:06:00Z"},{"type":"mrkdwn","text":"*Why:*\nUser login activity from a rare country"}]},{"type":"actions","elements":[{"type":"button","text":{"type":"plain_text","emoji":true,"text":"Authorized Activity"},"style":"primary","value":"authorized_activity"},{"type":"button","text":{"type":"plain_text","text":"Unknown"},"style":"danger","value":"unknown"}]}]}`

### Output

| **Parameter**                    | **Type** | **Description**                  |
| -------------------------------- | -------- | -------------------------------- |
| `headers`                        | object   | HTTP headers for the request     |
| `reason`                         | string   | Response reason phrase           |
| `status_code`                    | number   | HTTP status code of the response |
| `channel`                        | string   | Output field: channel            |
| `ts`                             | string   | Output field: ts                 |
| `message`                        | object   | Response message                 |
| `message.bot_id`                 | string   | Unique identifier                |
| `message.type`                   | string   | Type of the resource             |
| `message.text`                   | string   | Response message                 |
| `message.user`                   | string   | Response message                 |
| `message.ts`                     | string   | Response message                 |
| `message.app_id`                 | string   | Unique identifier                |
| `message.blocks`                 | array    | Response message                 |
| `message.blocks.type`            | string   | Type of the resource             |
| `message.blocks.block_id`        | string   | Unique identifier                |
| `message.blocks.text`            | object   | Response message                 |
| `message.blocks.text.type`       | string   | Type of the resource             |
| `message.blocks.text.text`       | string   | Response message                 |
| `message.blocks.text.verbatim`   | boolean  | Response message                 |
| `message.blocks.fields`          | array    | Response message                 |
| `message.blocks.fields.type`     | string   | Type of the resource             |
| `message.blocks.fields.text`     | string   | Response message                 |
| `message.blocks.fields.verbatim` | boolean  | Response message                 |
| `message.blocks.elements`        | array    | Response message                 |
| `message.blocks.elements.type`   | string   | Type of the resource             |

### Output Example

`{"channel":"string","ts":"string","message":{"bot_id":"string","type":"string","text":"string","user":"string","ts":"string","app_id":"string","blocks":[{}],"team":"string","bot_profile":{"id":"12345678-1234-1234-1234-123456789abc","app_id":"string","name":"Example Name","icons":{},"deleted":true,"updated":123,"team_id":"string"}}}`

## Conversations Archive

Archive a specified Slack channel by providing the channel identifier to remove it from active conversations.

### Endpoint

- **URL:** `api/conversations.archive`
- **Method:** `POST`

### Input

| **Argument Name**    | **Type** | **Required** | **Description**                                 |
| -------------------- | -------- | ------------ | ----------------------------------------------- |
| `parameters.channel` | string   | Required     | Parameters for the Conversations Archive action |

### Input Example

`{"parameters":{"channel":"C0E7PH2NS"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `status_code` | number   | HTTP status code of the response |
| `reason`      | string   | Response reason phrase           |
| `ok`          | boolean  | Output field: ok                 |
| `error`       | string   | Error message if any             |

### Output Example

`{"status_code":200,"response_headers":{"date":"Fri, 16 Dec 2022 15:18:40 GMT","server":"Apache","x-powered-by":"HHVM/4.153.1","access-control-allow-origin":"*","referrer-policy":"no-referrer","x-slack-backend":"r","x-slack-unique-id":"Y5yMUDFht5tyqlxLCMOeoQAAEBg","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x...","access-control-expose-headers":"x-slack-req...`

## Conversations Create

Initiate a new public or private channel in Slack by specifying the desired channel name.

### Endpoint

- **URL:** `api/conversations.create`
- **Method:** `POST`

### Input

| **Argument Name**       | **Type** | **Required** | **Description**                                |
| ----------------------- | -------- | ------------ | ---------------------------------------------- |
| `parameters.name`       | string   | Required     | Parameters for the Conversations Create action |
| `parameters.is_private` | boolean  | Optional     | Parameters for the Conversations Create action |

### Input Example

`{"parameters":{"name":"test_channel23","is_private":false}}`

### Output

| **Parameter**                      | **Type** | **Description**                                |
| ---------------------------------- | -------- | ---------------------------------------------- |
| `status_code`                      | number   | HTTP status code of the response               |
| `reason`                           | string   | Response reason phrase                         |
| `ok`                               | boolean  | Output field: ok                               |
| `channel`                          | object   | Output field: channel                          |
| `channel.id`                       | string   | Unique identifier                              |
| `channel.name`                     | string   | Name of the resource                           |
| `channel.is_channel`               | boolean  | Output field: channel.is\_channel              |
| `channel.is_group`                 | boolean  | Output field: channel.is\_group                |
| `channel.is_im`                    | boolean  | Output field: channel.is\_im                   |
| `channel.is_mpim`                  | boolean  | Output field: channel.is\_mpim                 |
| `channel.is_private`               | boolean  | Output field: channel.is\_private              |
| `channel.created`                  | number   | Output field: channel.created                  |
| `channel.is_archived`              | boolean  | Output field: channel.is\_archived             |
| `channel.is_general`               | boolean  | Output field: channel.is\_general              |
| `channel.unlinked`                 | number   | Output field: channel.unlinked                 |
| `channel.name_normalized`          | string   | Name of the resource                           |
| `channel.is_shared`                | boolean  | Output field: channel.is\_shared               |
| `channel.is_org_shared`            | boolean  | Output field: channel.is\_org\_shared          |
| `channel.is_pending_ext_shared`    | boolean  | Output field: channel.is\_pending\_ext\_shared |
| `channel.pending_shared`           | array    | Output field: channel.pending\_shared          |
| `channel.pending_shared.file_name` | string   | Name of the resource                           |
| `channel.pending_shared.file`      | string   | Output field: channel.pending\_shared.file     |
| `channel.context_team_id`          | string   | Unique identifier                              |
| `channel.updated`                  | number   | Output field: channel.updated                  |
| `channel.parent_conversation`      | object   | Output field: channel.parent\_conversation     |

### Output Example

`{"status_code":200,"response_headers":{"date":"Fri, 16 Dec 2022 14:33:36 GMT","server":"Apache","x-powered-by":"HHVM/4.153.1","access-control-allow-origin":"*","referrer-policy":"no-referrer","x-slack-backend":"r","x-slack-unique-id":"Y5yBwKgib4832auTRSYC9gAAAC4","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x...","access-control-expose-headers":"x-slack-req...`

## Conversations History

Retrieve the message and event history for a specific Slack channel using its unique identifier and optional parameters.

### Endpoint

- **URL:** `api/conversations.history`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                 |
| --------------------------------- | -------- | ------------ | ----------------------------------------------- |
| `parameters.channel`              | string   | Required     | Parameters for the Conversations History action |
| `parameters.include_all_metadata` | boolean  | Optional     | Parameters for the Conversations History action |
| `parameters.inclusive`            | boolean  | Optional     | Parameters for the Conversations History action |
| `parameters.limit`                | number   | Optional     | Parameters for the Conversations History action |
| `parameters.cursor`               | string   | Optional     | Parameters for the Conversations History action |

### Input Example

`{"parameters":{"channel":"C0E7PH2NS","include_all_metadata":true,"inclusive":true,"limit":2,"cursor":""}}`

### Output

| **Parameter**                       | **Type** | **Description**                  |
| ----------------------------------- | -------- | -------------------------------- |
| `status_code`                       | number   | HTTP status code of the response |
| `reason`                            | string   | Response reason phrase           |
| `ok`                                | boolean  | Output field: ok                 |
| `messages`                          | array    | Response message                 |
| `messages.type`                     | string   | Type of the resource             |
| `messages.user`                     | string   | Response message                 |
| `messages.text`                     | string   | Response message                 |
| `messages.ts`                       | string   | Response message                 |
| `messages.attachments`              | array    | Response message                 |
| `messages.attachments.service_name` | string   | Name of the resource             |
| `messages.attachments.text`         | string   | Response message                 |
| `messages.attachments.fallback`     | string   | Response message                 |
| `messages.attachments.thumb_url`    | string   | URL endpoint for the request     |
| `messages.attachments.thumb_width`  | number   | Unique identifier                |
| `messages.attachments.thumb_height` | number   | Response message                 |
| `messages.attachments.id`           | number   | Unique identifier                |
| `has_more`                          | boolean  | Output field: has\_more          |
| `pin_count`                         | number   | Count value                      |
| `response_metadata`                 | object   | Response data                    |
| `response_metadata.next_cursor`     | string   | Response data                    |

### Output Example

`{"ok":true,"messages":[{"type":"string","user":"string","text":"string","ts":"string","attachments":[]}],"has_more":true,"pin_count":123,"response_metadata":{"next_cursor":"string"}}`

## Conversations Invite

Invite specified users to a Slack channel by providing the channel ID and user identifiers.

### Endpoint

- **URL:** `api/conversations.invite`
- **Method:** `POST`

### Input

| **Argument Name**    | **Type** | **Required** | **Description**                                                                                                                          |
| -------------------- | -------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `parameters.channel` | string   | Required     | The ID of the public or private channel to invite user(s) to.                                                                            |
| `parameters.users`   | string   | Required     | A comma separated list of user IDs. Up to 100 users may be listed.                                                                       |
| `parameters.force`   | boolean  | Optional     | When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Defaults to false. |

### Input Example

`{"parameters":{"channel":"C0E7PH2NS","user":"USLACKBOT"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `status_code` | number   | HTTP status code of the response |
| `reason`      | string   | Response reason phrase           |
| `ok`          | boolean  | Output field: ok                 |
| `error`       | string   | Error message if any             |

### Output Example

`{"status_code":200,"response_headers":{"date":"Fri, 16 Dec 2022 15:14:14 GMT","server":"Apache","x-powered-by":"HHVM/4.153.1","access-control-allow-origin":"*","referrer-policy":"no-referrer","x-slack-backend":"r","x-slack-unique-id":"Y5yLRuVNB3Xwd5FZ_yySUQAAEAE","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x...","access-control-expose-headers":"x-slack-req...`

## Conversations Kick

Remove a specified user from a Slack channel by providing the channel and user identifiers.

### Endpoint

- **URL:** `api/conversations.kick`
- **Method:** `POST`

### Input

| **Argument Name**    | **Type** | **Required** | **Description**                              |
| -------------------- | -------- | ------------ | -------------------------------------------- |
| `parameters.channel` | string   | Required     | Parameters for the Conversations Kick action |
| `parameters.user`    | string   | Required     | Parameters for the Conversations Kick action |

### Input Example

`{"parameters":{"channel":"C0E7PH2NS","user":"USLACKBOT"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `status_code` | number   | HTTP status code of the response |
| `reason`      | string   | Response reason phrase           |
| `ok`          | boolean  | Output field: ok                 |
| `error`       | string   | Error message if any             |

### Output Example

`{"status_code":200,"response_headers":{"date":"Fri, 16 Dec 2022 14:12:52 GMT","server":"Apache","x-powered-by":"HHVM/4.153.1","access-control-allow-origin":"*","referrer-policy":"no-referrer","x-slack-backend":"r","x-slack-unique-id":"Y5x85Lpf1oI2rixfxSehaAAAEBY","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x...","access-control-expose-headers":"x-slack-req...`

## Conversations List

Retrieve all channels in a Slack team to provide an overview of available conversation spaces without requiring additional input.

### Endpoint

- **URL:** `api/conversations.list`
- **Method:** `GET`

### Input

| **Argument Name**  | **Type** | **Required** | **Description**                              |
| ------------------ | -------- | ------------ | -------------------------------------------- |
| `parameters.limit` | number   | Optional     | Parameters for the Conversations List action |

### Input Example

`{"parameters":{"limit":2}}`

### Output

| **Parameter**                       | **Type** | **Description**                                 |
| ----------------------------------- | -------- | ----------------------------------------------- |
| `status_code`                       | number   | HTTP status code of the response                |
| `reason`                            | string   | Response reason phrase                          |
| `ok`                                | boolean  | Output field: ok                                |
| `channels`                          | array    | Output field: channels                          |
| `channels.id`                       | string   | Unique identifier                               |
| `channels.name`                     | string   | Name of the resource                            |
| `channels.is_channel`               | boolean  | Output field: channels.is\_channel              |
| `channels.is_group`                 | boolean  | Output field: channels.is\_group                |
| `channels.is_im`                    | boolean  | Output field: channels.is\_im                   |
| `channels.is_mpim`                  | boolean  | Output field: channels.is\_mpim                 |
| `channels.is_private`               | boolean  | Output field: channels.is\_private              |
| `channels.created`                  | number   | Output field: channels.created                  |
| `channels.is_archived`              | boolean  | Output field: channels.is\_archived             |
| `channels.is_general`               | boolean  | Output field: channels.is\_general              |
| `channels.unlinked`                 | number   | Output field: channels.unlinked                 |
| `channels.name_normalized`          | string   | Name of the resource                            |
| `channels.is_shared`                | boolean  | Output field: channels.is\_shared               |
| `channels.is_org_shared`            | boolean  | Output field: channels.is\_org\_shared          |
| `channels.is_pending_ext_shared`    | boolean  | Output field: channels.is\_pending\_ext\_shared |
| `channels.pending_shared`           | array    | Output field: channels.pending\_shared          |
| `channels.pending_shared.file_name` | string   | Name of the resource                            |
| `channels.pending_shared.file`      | string   | Output field: channels.pending\_shared.file     |
| `channels.context_team_id`          | string   | Unique identifier                               |
| `channels.updated`                  | number   | Output field: channels.updated                  |
| `channels.parent_conversation`      | object   | Output field: channels.parent\_conversation     |

### Output Example

`{"ok":true,"channels":[{"id":"12345678-1234-1234-1234-123456789abc","name":"Example Name","is_channel":true,"is_group":true,"is_im":true,"is_mpim":true,"is_private":true,"created":123,"is_archived":true,"is_general":true,"unlinked":123,"name_normalized":"Example Name","is_shared":true,"is_org_shared":true,"is_pending_ext_shared":true}],"response_metadata":{"next_cursor":"string"}}`

## Conversations Members

Retrieve all members of a specified Slack channel by providing the channel ID as a parameter.

### Endpoint

- **URL:** `api/conversations.members`
- **Method:** `GET`

### Input

| **Argument Name**    | **Type** | **Required** | **Description**                                 |
| -------------------- | -------- | ------------ | ----------------------------------------------- |
| `parameters.channel` | string   | Required     | Parameters for the Conversations Members action |
| `parameters.limit`   | number   | Optional     | Parameters for the Conversations Members action |

### Input Example

`{"parameters":{"channel":"C0E7PH2NS","limit":2}}`

### Output

| **Parameter**                   | **Type** | **Description**                  |
| ------------------------------- | -------- | -------------------------------- |
| `status_code`                   | number   | HTTP status code of the response |
| `reason`                        | string   | Response reason phrase           |
| `ok`                            | boolean  | Output field: ok                 |
| `members`                       | array    | Output field: members            |
| `response_metadata`             | object   | Response data                    |
| `response_metadata.next_cursor` | string   | Response data                    |

### Output Example

`{"status_code":200,"response_headers":{"date":"Fri, 16 Dec 2022 14:07:50 GMT","server":"Apache","x-powered-by":"HHVM/4.153.1","access-control-allow-origin":"*","referrer-policy":"no-referrer","x-slack-backend":"r","x-slack-unique-id":"Y5x7tuDJgIq_ncq0sDiaPQAAECw","strict-transport-security":"max-age=31536000; includeSubDomains; preload","access-control-allow-headers":"slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x...","access-control-expose-headers":"x-slack-req...`

## Get Message Permalink

Retrieve the permalink URL for a specific Slack message by providing the channel ID and message timestamp.

### Endpoint

- **URL:** `api/chat.getPermalink`
- **Method:** `GET`

### Input

| **Argument Name**       | **Type** | **Required** | **Description**                                                 |
| ----------------------- | -------- | ------------ | --------------------------------------------------------------- |
| `parameters.channel`    | string   | Required     | The ID of the conversation or channel containing the message.   |
| `parameters.message_ts` | string   | Required     | A Message's TS value, uniquely identifying it within a channel. |

### Input Example

`{"parameters":{"channel":"C1234567890","message_ts":"1234567890.123456"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `status_code` | number   | HTTP status code of the response |
| `reason`      | string   | Response reason phrase           |
| `ok`          | boolean  | Output field: ok                 |
| `permalink`   | string   | Output field: permalink          |
| `channel`     | string   | Output field: channel            |

### Output Example

`{"status_code":200,"response_headers":{"date":"Wed, 16 Oct 2024 10:52:06 GMT","server":"Apache","vary":"Accept-Encoding","x-slack-req-id":"13dabbfa12beeaefe788b03b2f6ace65","x-content-type-options":"nosniff","x-xss-protection":"0","pragma":"no-cache","cache-control":"private, no-cache, no-store, must-revalidate","expires":"Sat, 26 Jul 1997 05:00:00 GMT","content-type":"application/json; charset=utf-8","x-oauth-scopes":"chat:write,channels:history,channels:join,channels:manage,channels:read,chat:...`

## Lookup by Email

Retrieve Slack user details by providing an email address to identify and return user profile information.

### Endpoint

- **URL:** `/api/users.lookupByEmail`
- **Method:** `GET`

### Input

| **Argument Name**  | **Type** | **Required** | **Description**                           |
| ------------------ | -------- | ------------ | ----------------------------------------- |
| `parameters.email` | string   | Required     | Parameters for the Lookup by Email action |

### Input Example

`{"parameters":{"email":"spengler@ghostbusters.example.com"}}`

### Output

| **Parameter**                            | **Type** | **Description**                   |
| ---------------------------------------- | -------- | --------------------------------- |
| `status_code`                            | number   | HTTP status code of the response  |
| `reason`                                 | string   | Response reason phrase            |
| `ok`                                     | boolean  | Output field: ok                  |
| `user`                                   | object   | Output field: user                |
| `user.id`                                | string   | Unique identifier                 |
| `user.team_id`                           | string   | Unique identifier                 |
| `user.name`                              | string   | Name of the resource              |
| `user.deleted`                           | boolean  | Output field: user.deleted        |
| `user.color`                             | string   | Output field: user.color          |
| `user.real_name`                         | string   | Name of the resource              |
| `user.tz`                                | string   | Output field: user.tz             |
| `user.tz_label`                          | string   | Output field: user.tz\_label      |
| `user.tz_offset`                         | number   | Output field: user.tz\_offset     |
| `user.profile`                           | object   | Output field: user.profile        |
| `user.profile.title`                     | string   | Output field: user.profile.title  |
| `user.profile.phone`                     | string   | Output field: user.profile.phone  |
| `user.profile.skype`                     | string   | Output field: user.profile.skype  |
| `user.profile.real_name`                 | string   | Name of the resource              |
| `user.profile.real_name_normalized`      | string   | Name of the resource              |
| `user.profile.display_name`              | string   | Name of the resource              |
| `user.profile.display_name_normalized`   | string   | Name of the resource              |
| `user.profile.fields`                    | object   | Output field: user.profile.fields |
| `user.profile.status_text`               | string   | Status value                      |
| `user.profile.status_emoji`              | string   | Status value                      |
| `user.profile.status_emoji_display_info` | array    | Status value                      |

### Output Example

`{"ok":true,"user":{"id":"12345678-1234-1234-1234-123456789abc","team_id":"string","name":"Example Name","deleted":true,"color":"string","real_name":"Example Name","tz":"string","tz_label":"string","tz_offset":123,"profile":{"title":"string","phone":"string","skype":"string","real_name":"Example Name","real_name_normalized":"Example Name","display_name":"Example Name","display_name_normalized":"Example Name","fields":{},"status_text":"active","status_emoji":"active","status_emoji_display_info":[]...`

## test

Verify the connection to Slack and ensure that integration functionality is working correctly.

### Endpoint

- **URL:** `sf`
- **Method:** `fa`

### Input

| **Argument Name** | **Type** | **Required** | **Description**    |
| ----------------- | -------- | ------------ | ------------------ |
| `ads`             | object   | Optional     | Parameter for test |
| `sad`             | object   | Optional     | Parameter for test |

### Input Example

`{"ads":{},"sad":{}}`

## Update Message

Modify an existing message in a specified Slack channel by providing the channel ID and message timestamp.

### Endpoint

- **Method:** `POST`

### Input

| **Argument Name**    | **Type** | **Required** | **Description**              |
| -------------------- | -------- | ------------ | ---------------------------- |
| `channel`            | string   | Required     | Parameter for Update Message |
| `message_timestamp`  | string   | Required     | Response message             |
| `title`              | string   | Optional     | Parameter for Update Message |
| `reply_broadcast`    | string   | Optional     | Parameter for Update Message |
| `username`           | string   | Optional     | Name of the resource         |
| `parse`              | string   | Optional     | Parameter for Update Message |
| `link_names`         | string   | Optional     | Name of the resource         |
| `text`               | string   | Optional     | Parameter for Update Message |
| `unfurl_links`       | string   | Optional     | URL endpoint for the request |
| `unfurl_media`       | string   | Optional     | URL endpoint for the request |
| `icon_url`           | string   | Optional     | URL endpoint for the request |
| `icon_emoji`         | string   | Optional     | Parameter for Update Message |
| `blocks`             | array    | Optional     | Parameter for Update Message |
| `blocks.type`        | string   | Optional     | Type of the resource         |
| `blocks.text`        | object   | Optional     | Parameter for Update Message |
| `blocks.text.type`   | string   | Optional     | Type of the resource         |
| `blocks.text.text`   | string   | Optional     | Parameter for Update Message |
| `blocks.fields`      | array    | Optional     | Parameter for Update Message |
| `blocks.fields.type` | string   | Optional     | Type of the resource         |
| `blocks.fields.text` | string   | Optional     | Parameter for Update Message |

### Input Example

`{"channel":"C04J0U2RUMT","message_timestamp":"1673382207.766669","title":"C04J0U2RUMT","reply_broadcast":"C04J0U2RUMT","username":"C04J0U2RUMT","parse":"C04J0U2RUMT","link_names":"C04J0U2RUMT","text":"C04J0U2RUMT","unfurl_links":"C04J0U2RUMT","unfurl_media":"C04J0U2RUMT","icon_url":"C04J0U2RUMT","icon_emoji":"C04J0U2RUMT"}`

### Output

| **Parameter**                    | **Type** | **Description**                  |
| -------------------------------- | -------- | -------------------------------- |
| `headers`                        | object   | HTTP headers for the request     |
| `reason`                         | string   | Response reason phrase           |
| `status_code`                    | number   | HTTP status code of the response |
| `channel`                        | string   | Output field: channel            |
| `ts`                             | string   | Output field: ts                 |
| `message`                        | object   | Response message                 |
| `message.bot_id`                 | string   | Unique identifier                |
| `message.type`                   | string   | Type of the resource             |
| `message.text`                   | string   | Response message                 |
| `message.user`                   | string   | Response message                 |
| `message.app_id`                 | string   | Unique identifier                |
| `message.blocks`                 | array    | Response message                 |
| `message.blocks.type`            | string   | Type of the resource             |
| `message.blocks.block_id`        | string   | Unique identifier                |
| `message.blocks.text`            | object   | Response message                 |
| `message.blocks.text.type`       | string   | Type of the resource             |
| `message.blocks.text.text`       | string   | Response message                 |
| `message.blocks.text.verbatim`   | boolean  | Response message                 |
| `message.blocks.fields`          | array    | Response message                 |
| `message.blocks.fields.type`     | string   | Type of the resource             |
| `message.blocks.fields.text`     | string   | Response message                 |
| `message.blocks.fields.verbatim` | boolean  | Response message                 |
| `message.team`                   | string   | Response message                 |
| `message.bot_profile`            | object   | Response message                 |
| `message.bot_profile.id`         | string   | Unique identifier                |

### Output Example

`{"channel":"string","ts":"string","message":{"bot_id":"string","type":"string","text":"string","user":"string","app_id":"string","blocks":[{}],"team":"string","bot_profile":{"id":"12345678-1234-1234-1234-123456789abc","app_id":"string","name":"Example Name","icons":{},"deleted":true,"updated":123,"team_id":"string"},"edited":{"user":"string","ts":"string"}}}`

## URL Verification Handshake

Verify the integrity of a Slack webhook setup by confirming the challenge token included in the data body content.

### Endpoint

- **Method:** `POST`

### Input

| **Argument Name**     | **Type** | **Required** | **Description** |
| --------------------- | -------- | ------------ | --------------- |
| `data_body`           | object   | Required     | Response data   |
| `data_body.challenge` | string   | Required     | Response data   |

### Input Example

`{"data_body":{"channel":"C0E7PH2NS"}}`

### Output

| **Parameter** | **Type** | **Description**                  |
| ------------- | -------- | -------------------------------- |
| `headers`     | object   | HTTP headers for the request     |
| `reason`      | string   | Response reason phrase           |
| `status_code` | number   | HTTP status code of the response |

### Output Example

`{"headers":null,"reason":"OK","status_code":200}`

## Users List

Retrieve a comprehensive list of users in your Slack team, providing details about current team membership.

### Endpoint

- **URL:** `api/users.list`
- **Method:** `GET`

### Input

| **Argument Name**  | **Type** | **Required** | **Description**                      |
| ------------------ | -------- | ------------ | ------------------------------------ |
| `parameters.limit` | number   | Optional     | Parameters for the Users List action |

### Input Example

`{"parameters":{"limit":2}}`

### Output

| **Parameter**                             | **Type** | **Description**                      |
| ----------------------------------------- | -------- | ------------------------------------ |
| `status_code`                             | number   | HTTP status code of the response     |
| `reason`                                  | string   | Response reason phrase               |
| `ok`                                      | boolean  | Output field: ok                     |
| `offset`                                  | string   | Output field: offset                 |
| `members`                                 | array    | Output field: members                |
| `members.id`                              | string   | Unique identifier                    |
| `members.team_id`                         | string   | Unique identifier                    |
| `members.name`                            | string   | Name of the resource                 |
| `members.deleted`                         | boolean  | Output field: members.deleted        |
| `members.color`                           | string   | Output field: members.color          |
| `members.real_name`                       | string   | Name of the resource                 |
| `members.tz`                              | string   | Output field: members.tz             |
| `members.tz_label`                        | string   | Output field: members.tz\_label      |
| `members.tz_offset`                       | number   | Output field: members.tz\_offset     |
| `members.profile`                         | object   | Output field: members.profile        |
| `members.profile.title`                   | string   | Output field: members.profile.title  |
| `members.profile.phone`                   | string   | Output field: members.profile.phone  |
| `members.profile.skype`                   | string   | Output field: members.profile.skype  |
| `members.profile.real_name`               | string   | Name of the resource                 |
| `members.profile.real_name_normalized`    | string   | Name of the resource                 |
| `members.profile.display_name`            | string   | Name of the resource                 |
| `members.profile.display_name_normalized` | string   | Name of the resource                 |
| `members.profile.fields`                  | object   | Output field: members.profile.fields |
| `members.profile.status_text`             | string   | Status value                         |
| `members.profile.status_emoji`            | string   | Status value                         |

### Output Example

`{"ok":true,"offset":"string","members":[{"id":"12345678-1234-1234-1234-123456789abc","team_id":"string","name":"Example Name","deleted":true,"color":"string","real_name":"Example Name","tz":"string","tz_label":"string","tz_offset":123,"profile":{},"is_admin":true,"is_owner":true,"is_primary_owner":true,"is_restricted":true,"is_ultra_restricted":true}],"cache_ts":123,"response_metadata":{"next_cursor":"string"}}`

# Response Headers

| **Header**                         | **Description**                                            | **Example**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| access-control-allow-headers       | HTTP response header: access-control-allow-headers         | slack-route, x-slack-version-ts, x-b3-traceid, x-b3-spanid, x-b3-parentspanid, x-b3-sampled, x-b3-flags                                                                                                                                                                                                                                                                                                                                                                                        |
| access-control-allow-origin        | HTTP response header: access-control-allow-origin          | \*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| access-control-expose-headers      | HTTP response header: access-control-expose-headers        | x-slack-req-id, retry-after                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| cache-control                      | Directives for caching mechanisms                          | private, no-cache, no-store, must-revalidate                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| content-encoding                   | HTTP response header: content-encoding                     | gzip                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| content-length                     | The length of the response body in bytes                   | 698                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Content-Type                       | The media type of the resource                             | application/json                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| date                               | The date and time at which the message was originated      | Fri, 16 Dec 2022 14:12:52 GMT                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| expires                            | The date/time after which the response is considered stale | Sat, 26 Jul 1997 05:00:00 GMT                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| pragma                             | HTTP response header: pragma                               | no-cache                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| referrer-policy                    | HTTP response header: referrer-policy                      | no-referrer                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| server                             | Information about the software used by the origin server   | Apache                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| strict-transport-security          | HTTP response header: strict-transport-security            | max-age=31536000; includeSubDomains; preload                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| vary                               | HTTP response header: vary                                 | Accept-Encoding                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| via                                | HTTP response header: via                                  | envoy-www-iad-s7mf, envoy-edge-gru-7het                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| x-accepted-oauth-scopes            | HTTP response header: x-accepted-oauth-scopes              | channels\:read,groups\:read,mpim\:read,im\:read,read                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| x-backend                          | HTTP response header: x-backend                            | main\_normal main\_bedrock\_normal\_with\_overflow main\_canary\_with\_overflow main\_bedrock\_canary\_with\_overflow main\_control\_with\_overflow main\_bedrock\_control\_with\_overflow                                                                                                                                                                                                                                                                                                     |
| x-content-type-options             | HTTP response header: x-content-type-options               | nosniff                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| x-edge-backend                     | HTTP response header: x-edge-backend                       | envoy-www                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| x-envoy-attempt-count              | HTTP response header: x-envoy-attempt-count                | 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| x-envoy-upstream-service-time      | HTTP response header: x-envoy-upstream-service-time        | 132                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| x-oauth-scopes                     | HTTP response header: x-oauth-scopes                       | app\_mentions\:read,channels\:history,channels\:join,channels\:manage,channels\:read,chat\:write.customize,chat\:write.public,chat\:write,files\:read,files\:write,groups\:history,groups\:read,groups\:write,im\:history,im\:read,im\:write,links\:read,links\:write,mpim\:history,mpim\:read,mpim\:write,pins\:read,pins\:write,reactions\:read,reactions\:write,reminders\:read,reminders\:write,team\:read,usergroups\:read,usergroups\:write,users\:read,users\:write,users.profile\:read |
| x-powered-by                       | HTTP response header: x-powered-by                         | HHVM/4.153.1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| x-server                           | HTTP response header: x-server                             | slack-www-hhvm-main-iad-yioh                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| x-slack-backend                    | HTTP response header: x-slack-backend                      | r                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| x-slack-edge-shared-secret-outcome | HTTP response header: x-slack-edge-shared-secret-outcome   | no-match                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| x-slack-req-id                     | HTTP response header: x-slack-req-id                       | 4b8e72501927109ea109f3d47d2dfee2                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| x-slack-shared-secret-outcome      | HTTP response header: x-slack-shared-secret-outcome        | no-match                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| x-slack-unique-id                  | HTTP response header: x-slack-unique-id                    | Zw-a1qlgB2l9h\_MWjXCEgQAAEDQ                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| x-xss-protection                   | HTTP response header: x-xss-protection                     | 0                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
