Find conversation

findConversation resolves an exact public or private channel name or ID. Use it when configuration contains a human-readable channel name but later actions need a stable ID.

Example

automations/find-support-channel.automation.ts

import { automation } from "automate.ax"
import { findConversation } from "automate.ax/slack"

export default automation("Find support channel", () => {
  findConversation({ conversation: "#support" })
})

Inputs

Input	Type	Required	Default	Description
`conversation`	`string`	Yes	—	Exact channel name, optionally beginning with `#`, or conversation ID.
`includeArchived`	`boolean`	No	`false`	Includes archived channels in name lookup.
`account`	`string \| IntegrationAccountReference<"slack">`	No	Project default	Slack workspace binding.

Output

Returns a normalized SlackConversation with stable id and available name, visibility, membership, topic, purpose, creation, creator, and member metadata. Lookup compares names case-insensitively across every accessible public and private channel. It fails if there is no match or if an exact name matches more than one channel; use an ID to avoid ambiguity.

⌘I

Get started

Concepts

Reference

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output