Overview
Coral handles the OAuth authorization and token management for third-party apps. When you connect an app, you authorize it through a secure OAuth flow — your tokens are managed securely and never stored in your sandbox. Your assistant can then use these connections to perform actions like reading emails, creating issues, updating spreadsheets, and more.Available App Categories
Google Suite
Gmail, Calendar, Docs, Sheets, Slides, Drive, Tasks, Maps, Analytics, Meet.
Microsoft Suite
Teams, Outlook, OneDrive, SharePoint, Excel.
Developer & PM
GitHub, GitLab, Bitbucket, Asana, Linear, Trello, ClickUp, Confluence, Sentry.
CRM & Sales
HubSpot, Salesforce, Attio, Intercom, Zendesk.
Productivity
Notion, Airtable, Zoom, Dropbox, Figma, Slack, Monday, Todoist, Calendly, Miro, Canva.
Finance & Commerce
Stripe, Square, QuickBooks, Xero, FreshBooks.
Connecting an App
- Open the Coral dashboard and go to the Integrations page.
- Scroll down to the App Integrations section.
- Find the app you want to connect and click “Connect”.
- You’ll be redirected to the app’s authorization page (e.g., Google’s OAuth consent screen).
- Sign in and grant the requested permissions.
- You’ll be redirected back to Coral. The app will show as Connected.
Some apps may require additional configuration (e.g., selecting specific repositories for GitHub, or choosing a workspace for Notion). Follow the on-screen prompts during the authorization flow.
Using Connected Apps
Once an app is connected, your assistant automatically gains access to the app’s actions. You can simply ask your assistant to perform tasks, for example:- “Check my Gmail for unread emails from today”
- “Create a new issue in my Linear project for the login bug”
- “Add a row to my Google Sheet with today’s sales numbers”
- “Schedule a meeting on Google Calendar for tomorrow at 2pm”
- “Find the latest PR comments on my GitHub repo”
Disconnecting an App
- Go to the Integrations page.
- Find the connected app.
- Click “Disconnect”.
Troubleshooting
| Problem | Solution |
|---|---|
| App shows “Connected” but assistant can’t use it | The gateway may need a restart. Try disconnecting and reconnecting the app. |
| OAuth page shows an error | Ensure your account has the necessary permissions for the app (e.g., admin access for some workspace-level apps). |
| Assistant says it doesn’t have access to an app | Check the Integrations page to confirm the app is connected. If it says “Disconnected”, reconnect it. |
| ”Authorization expired” | Some apps require periodic re-authorization. Click “Connect” again to refresh the authorization. |
Security
- OAuth tokens are managed securely — they are not stored in your sandbox.
- Coral communicates with app providers through a server-side proxy. API keys never reach your browser or sandbox.
- Each user’s connections are isolated — your Coral user ID maps to a unique identity.
- Tool execution happens through Coral’s authenticated proxy infrastructure.