🚨 Slack Error: 'ura_max_channels' — Cause, Fix, and Troubleshooting Guide

Overview

ura_max_channels is returned by conversations.invite when the invited user is a single-channel guest (“ultra restricted access”, hence ura) who is already in the maximum number of conversations their account type allows. By definition a single-channel guest belongs to one channel; inviting them to another exceeds that.

{
    "ok": false,
    "error": "ura_max_channels"
}

Symptoms

• Inviting a specific external/guest user fails while inviting regular members succeeds.
• The user is a restricted guest account, not a full member.
• The error is user-specific, not channel- or scope-specific.

Common Root Causes

1. Inviting a single-channel guest to a second channel

Single-channel guests are capped at one channel; a second invite trips the limit.

2. Guest already at their allotted channel count

An ultra-restricted account is at its maximum and cannot be added to more.

3. Bulk invite includes guest accounts

An automation invites a mixed roster that contains single-channel guests without accounting for their limits.

How to diagnose

Check the account type via users.info:

curl -s "https://slack.com/api/users.info?user=U0GUEST001" \
  -H "Authorization: Bearer $SLACK_BOT_TOKEN"

{"ok": true, "user": {"id": "U0GUEST001", "is_ultra_restricted": true, "is_restricted": true}}

is_ultra_restricted: true marks a single-channel guest — the source of ura_max_channels.

Fixes

• Convert the account type: an admin can change a single-channel guest to a multi-channel guest (or full member) so they can join additional channels.
• Don’t invite single-channel guests to extra channels — respect the one-channel constraint in your automation.
• Filter rosters: skip is_ultra_restricted users in bulk-invite flows, or handle them separately.

What to watch out for

• This is an account-type policy, not a bug — the fix usually lives with a workspace admin, not in code.
• is_ultra_restricted (single-channel guest) vs is_restricted (multi-channel guest): only the former is capped at one channel.
• For external collaboration across channels, Slack Connect shared channels are often the better model than guest accounts.

Related

• Slack Error: ‘not_in_channel’
• Slack Error: ‘restricted_action’
• Securing Slack Connect shared channels for ops