Slack

Create a public or private conversation in Slack. This atomic requires one of the following API scopes depending on usage: channels:manage, groups:write, im:write, mpim:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the request payload
[] Request the conversation be created
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the conversation information and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.create

Slack - Create Conversation

prod-nam

prod-eu

prod-apjc

Opens or resumes a direct message or multi-person direct message in Slack. This atomic requires one of the following API scopes depending on usage: channels:manage, groups:write, im:write, mpim:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Make sure a channel or user was provided:
[]> If not, return an error
[] Build the authorization header and the request payload
[] Request the conversation be created
[] Check if the request was successful:
[]> If not, return an error
[] Extract the request status
[] Check if the request status is successful:
[]> If it is, attempt to extract the conversation information and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.open

Slack - Create Direct Conversation

Deletes a chat message from a Slack conversation. This atomic requires the following API scope: chat:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the request payload
[] Request the message be deleted
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/chat.delete

Slack - Delete Message

Searches for a Slack user by their email address. This atomic requires the following API scope: users:read.email.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header
[] Search for the user
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the user information and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/users.lookupByEmail

Slack - Find User by Email Address

Fetches a user's profile from Slack. This atomic requires the following API scope: users:read.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and query string
[] Request the user profile
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the profile information and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/users.info

Slack - Get User Profile

Invites one or more users to a conversation in Slack. This atomic requires one of the following API scopes depending on usage: channels:write.invites, groups:write.invites, channels:manage, groups:write, im:write, mpim:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the request payload
[] Request the users be invited
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.invite

Slack - Invite User to Conversation

Joins an existing conversation in Slack. This atomic requires the following API scope: channels:join.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the request payload
[] Request to join the conversation
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.join

Slack - Join Conversation

Retrieves a list of existing conversations from Slack. This atomic requires one of the following API scopes depending on usage: channels:read, groups:read, im:read, mpim:read.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and query string
[] Get the conversation list
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the conversation information and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.list

Slack - List Conversations

Posts a chat message in a Slack conversation. This atomic requires the following API scope: chat:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Make sure at least one of the content variables was provided:
[]> If not, return an error
[] Build the authorization header and the request payload
[] Post the message
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the message data and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/chat.postMessage

Slack - Post Chat Message

Posts an ephemeral message in a Slack conversation. Ephemeral messages are only visible to a specific user and are meant to be temporary. This atomic requires the following API scope: chat:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Make sure at least one of the content variables was provided:
[]> If not, return an error
[] Build the authorization header and the request payload
[] Post the message
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the message data and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/chat.postEphemeral

Slack - Post Ephemeral Message

Sets the topic of a Slack conversation. This atomic requires one of the following API scopes depending on usage: channels:write.topic, groups:write.topic, mpim:write.topic, im:write.topic, channels:manage, groups:write, im:write, mpim:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Build the authorization header and the request payload
[] Request the conversation topic be set
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/conversations.setTopic

Slack - Set Conversation Topic

Updates an existing chat message in Slack. This atomic requires the following API scope: chat:write.

Target: Slack integration target or an HTTP Endpoint for "slack.com" with a path of "/api"

Account Key: None if using an integration-provided target, access token if using an HTTP Endpoint target

Steps:
[] Make sure at least one of the content variables was provided:
[]> If not, return an error
[] Build the authorization headers and the request payload
[] Request the message be updated
[] Check if the request was successful:
[]> If it wasn't, return an error
[] Extract the request status
[] Check if the request status was successful:
[]> If it was, attempt to extract the message data and set the output variables
[]> If it wasn't, return an error

More information about this API: https://api.slack.com/methods/chat.update