Connection troubleshooting

← All help articles

"Needs attention" on a connector card

The card shows the exact error we got. Most cures are one of: reconnect (tokens expired or were revoked upstream), re-key (Atlassian expires org keys after a year — the card shows your date), or permissions (below).

"Zero seats" refusal

If a sync returns an empty roster from a live connector, we refuse to apply it rather than wipe your data — the person who connected is always a member themselves, so empty means wrong org, wrong permissions, or a vendor quirk. Reconnect with the right account; mail support if it persists.

Wrong key type

OpenAI needs an organization Admin key (sk-admin…), not a project key. Anthropic Enterprise needs an Analytics key from claude.ai, and Claude Team has no API at all — use the CSV. Atlassian keys must be Organization admin keys with the right scope — the guide shows the exact checkbox.

HubSpot says you lack permissions

HubSpot caps an OAuth grant at the authorizing user's own permissions, and we read user + security data — so a Super Admin must click the connect. Portal managed by an agency or reseller? They hold those permissions; ask them for user management and audit log access on your user. It's your data.

Google says "not part of a Workspace organization"

You connected a personal Gmail account. The connector needs a Google Workspace admin — or take the CSV route.