> ## 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.

# List group direct messages

> List Slack multi-person direct-message conversations visible to the bot.

`listGroupDirectMessages` lists multi-person direct-message conversations. Use
it when you need Slack's group-DM conversation IDs rather than channel IDs.

## Example

```ts automations/list-group-dms.automation.ts theme={null}
import { automation } from "automate.ax"
import { listGroupDirectMessages } from "automate.ax/slack"

export default automation("List Slack group DMs", () => {
  listGroupDirectMessages({ limit: 100 })
})
```

## Inputs

| Input     | Type                                             | Required | Default         | Description                                   |
| --------- | ------------------------------------------------ | -------- | --------------- | --------------------------------------------- |
| `cursor`  | `string`                                         | No       | First page      | Opaque cursor returned by the preceding page. |
| `limit`   | `number`                                         | No       | Slack default   | Requested page size from 1 to 200.            |
| `account` | `string \| IntegrationAccountReference<"slack">` | No       | Project default | Slack workspace binding.                      |

## Output

Returns `Signal<{ conversations: SlackConversation[]; responseMetadata: { nextCursor?: string } }>`.
Group DMs report `isGroupDirectMessage` when Slack supplies the flag. Continue
pagination with `nextCursor`.