- Connected apps — everything already wired up, pinned at the top and ready for your assistant to use.
- Needs attention — apps that need a reconnect or configuration update before they’ll work again.
- Available apps — the full catalog, scrolling below.
Connecting an app
Open the app's card
Click a card to see the details before connecting: a description, the
access scopes the app will ask for, and the full list of tools
your assistant would gain — so you know exactly what you’re granting.
Click Connect and label the account
You can add an optional label so the account is easy to recognize later —
“Work Slack”, “Personal Gmail”, “Client Discord”. Labels matter most when
you connect more than one account to the same app.
Multiple accounts per app
You can connect the same app more than once — a work HubSpot and a client HubSpot, say. Each connected account:- has its own label (rename any time),
- has its own tool permissions (see Permissions & security),
- can be tested, reconnected, or disconnected independently.
Keeping connections healthy
Each account row shows its health — Healthy or Needs attention — and you can hit Test any time to check a connection. The card and account badges tell you exactly where things stand:| Badge | Meaning |
|---|---|
| Connected / Configured | Working — authorized (OAuth) or credentialed (API key) |
| Connecting | Authorization in progress |
| Needs attention / Reconnect | An expired login, revoked grant, or missing permission — reconnect to fix |
| Needs setup | Something must be configured before connecting (see below) |
| Not connected | Available in the catalog, not yet linked |
Bring your own OAuth (admins)
Most OAuth apps connect with platform-managed credentials — click Connect and go. For organizations that want more control, each app’s detail view has a Bring your own OAuth section (admin-only) where you can register your organization’s own OAuth app instead. Reasons to bother:- Your branding on the consent screen — people authorizing see your organization’s app, not a generic one.
- Custom scopes — request exactly the permissions your workflows need.
- Apps without managed credentials — a few catalog apps can only be connected this way. Their cards say so (“Custom OAuth app required”) and stay unconnectable until an admin sets one up.
Apps not in the gallery
For services the gallery doesn’t cover, there’s a Custom secret option: store any key/value credential (likestripe/prod/API_KEY) with your
assistant, and it can use that credential to work with the service’s API
directly. See Using connected apps for how that plays
out in practice.