> ## Documentation Index
> Fetch the complete documentation index at: https://flywheel.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Slack Channel Invites (Agent Tool)
> Invite internal and external users to an existing Slack channel from an agent run
## How Send Slack Channel Invites Works
Send Slack invites into an existing channel. This tool is useful when the agent determines the right people should be pulled into a collaboration thread. It supports both internal team members and external customer-side users, allowing the agent to dynamically assemble the right group based on account context, event triggers, or role assignments. Invitations are processed in bulk and the tool reports back how many were successfully sent, making it easy to chain with follow-up messaging or logging actions.
## Configuration
Guidance for when this tool should be used during an agent run.
Target Slack workspace/team.
Existing Slack channel to invite users into.
Internal team members to invite.
Customer-side users to invite where applicable.
Total number of invite operations executed across internal and external users.
The Slack channel ID that users were invited to.
Array of Slack user IDs that were successfully invited to the channel.
Array of email addresses for external users that invitations were sent to.
Overall tool execution result for the run.
**Values:** `success`, `partial`, `error`
Error details when the invite operation fails. Empty on success.
## Use Cases
**Shared Channel Activation**
```
Channel: #customer-{{company.slug}}
Trigger: Customer requests a shared collaboration channel
Invite Team Members: [assigned_csm, solutions_engineer]
Invite External Users: [customer_admin, customer_champion]
```
**Onboarding Kickoff**
```
Channel: #onboarding-{{company.slug}}
Trigger: New customer onboarding starts
Invite Team Members: [assigned_csm, onboarding_specialist]
Invite External Users: [customer_technical_lead, customer_admin]
```
**Escalation War Room Staffing**
```
Channel: #escalation-{{ticket.id}}
Trigger: Support escalation event detected
Invite Team Members: [support_lead, engineering_oncall, assigned_csm]
Invite External Users: []
```
**Renewal Prep Collaboration**
```
Channel: #renewal-{{company.slug}}
Trigger: Renewal date within 60 days
Invite Team Members: [assigned_csm, account_executive]
Invite External Users: [customer_decision_maker]
```
## Best Practices
**Permissions & Access**
* Verify that the Slack bot has permission to invite users to the target channel before enabling live agent runs.
* Confirm that external guest or Slack Connect invitations are enabled in your Slack workspace admin settings.
* Use the `tool_status` output to detect partial failures where some invites succeed and others do not.
**Invite Strategy**
* Keep invitation lists focused — invite only the people who need to be in the channel to reduce noise.
* Use role-based references (e.g., `assigned_csm`, `customer_admin`) rather than hardcoded user IDs for flexibility across accounts.
* Combine with the Create Slack Channel tool when both channel creation and invitation need to happen in sequence.
**Follow-Up Actions**
* Pair invitations with a Slack Message tool to post an introductory message explaining the channel's purpose.
* Log the `invites_processed` count and `invited_user_ids` for audit trails and reporting.
* Monitor for `error` status and route failures to a fallback notification (e.g., email or internal alert) so invitations are not silently lost.