Opidocs
GuidesAssistant guides

Connect your first app

Link a connector like Gmail, Slack, or GitHub so the assistant can act in it.

Intermediate · ~10 min · Prerequisites: None

What you'll do

Authorize a connector so the assistant can read from and write to a third-party app on your behalf.

Find the app

Ask the assistant "what apps can I connect?" to see the full connector catalog, or open Integrations in the sidebar and browse the Connecting apps list.

Each connector card shows which actions it unlocks — reading emails, creating issues, posting messages — so you know what you're enabling before you authorize. See Connecting apps for the complete connector reference.

Authorize it

Click Connect on a connector card. The assistant opens an OAuth authorization window for the third-party app. Sign in with the account you want to link, then approve the requested permissions.

The window closes automatically when authorization succeeds. You don't need to copy tokens or paste credentials — the connector handles the exchange.

If you're on a shared workspace, your teammates don't inherit your connection. Each person authorizes their own account.

Confirm it's connected

Back in the Integrations panel the connector card shows a Connected badge. You can also ask the assistant: "Is my GitHub connected?" and it will confirm or tell you what's missing.

If the OAuth flow fails, the card stays in a Failed state with a retry link. Common causes are browser pop-up blockers or an expired session on the third-party side.

What it unlocks

Once connected, the assistant can use the app's actions in any conversation. Ask it to send a Slack message, open a GitHub issue, or search your Gmail — it routes to the right connector automatically based on your phrasing.

You can connect multiple accounts of the same type (for example, a personal and a work Gmail) and disambiguate by mentioning the account in your request.

Try this next

On this page