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

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# Slack

> This page outlines how to use the Slack integration to send messages and notifications from Cargo.

Slack is a leading business communication platform that brings teams together with real-time messaging, channels, and integrations. Cargo's native integration with Slack allows you to send messages, notifications, and alerts directly to channels or users as part of your workflows.

## How to set up Slack

Slack uses OAuth to establish the connection with Cargo. During connection, you'll be asked to authorize Cargo to access your Slack workspace.

Once redirected and the connector is created, you can:

* **Send messages from workflows** — Send notifications, alerts, and updates to Slack channels or users directly from your **Plays**, **Tools**, or **Agents**.
* **Keep teams informed** — Automate real-time notifications for important events like new leads, deal updates, or workflow completions.

***

## Slack actions

### Send message to channel

Post a message to a public or private Slack channel.

**Use cases**

* **Team notifications** – Alert your sales team when a high-value lead enters the pipeline
* **Deal updates** – Post to a deals channel when opportunities progress through stages
* **Workflow alerts** – Notify teams when automated workflows complete or require attention

<Tip>
  Use Slack's [Block Kit](https://api.slack.com/block-kit) formatting to create
  rich, interactive messages with buttons, sections, and more.
</Tip>

### Send direct message

Send a private message directly to a Slack user.

**Use cases**

* **Personal notifications** – Notify a specific rep when they're assigned a new lead
* **Task reminders** – Send individual reminders for follow-ups or pending actions
* **Escalations** – Alert managers directly when deals need attention

### Post threaded reply

Reply to an existing message in a thread.

**Use cases**

* **Conversation continuity** – Keep related updates organized in threads
* **Status updates** – Add progress updates to existing notification threads
* **Collaborative workflows** – Build context over time within a single thread

<Info>
  To post a threaded reply, you'll need the `thread_ts` (timestamp) of the
  parent message. This can be captured from a previous **Send message** action.
</Info>

***

## Message formatting

Slack supports rich text formatting using markdown-like syntax:

| Format            | Syntax          | Example                     |
| ----------------- | --------------- | --------------------------- |
| **Bold**          | `*text*`        | *important*                 |
| *Italic*          | `_text_`        | *emphasis*                  |
| ~~Strikethrough~~ | `~text~`        | ~~removed~~                 |
| `Code`            | `` `text` ``    | `variable`                  |
| Link              | `<url\|text>`   | `<https://cargo.io\|Cargo>` |
| User mention      | `<@USER_ID>`    | `<@U123ABC>`                |
| Channel mention   | `<#CHANNEL_ID>` | `<#C123ABC>`                |

<Warning>
  Ensure the Cargo app has been invited to private channels before attempting to
  post messages. The bot cannot access channels it hasn't been added to.
</Warning>