> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Find conversation

> Find an accessible Slack channel by exact name or ID.

`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

```ts automations/find-support-channel.automation.ts theme={null}
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.