- 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
1
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.
2
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.
3
Authorize
How you authorize depends on the app:
- OAuth — a new tab opens with the app’s own sign-in page. Approve, and you’re returned to the Console.
- API key — paste the key (or keys) into a short form; the connection is live immediately.
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:
Disconnecting removes the authorization for that assistant; you can reconnect
later if you need the app again. For apps connected with your own OAuth app
credentials, disconnecting keeps the client details saved so reconnecting is
one click.
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.