Connecting Integrations — Walkthrough Guide
Overview
Vantage connects to 30+ third-party services to import data, trigger workflows, and sync information. Integrations are managed through the Integrations page and can be used as data sources for dashboard tiles and workflow nodes.
Accessing Integrations
Click "Integrations" in the sidebar to see all available integrations and their connection status.
Available Integrations
| Category | Integrations |
|---|---|
| Databases | PostgreSQL, MySQL, MSSQL, MongoDB, DynamoDB, Firestore, Redis |
| Cloud Storage | Google Drive, OneDrive, AWS S3 |
| Communication | Gmail, Outlook Mail, Slack, Teams Chat |
| Calendar | Google Calendar, Outlook Calendar |
| Notes | OneNote |
| Project Management | Asana, Jira, GitHub |
| Social Media | Instagram, Meta (Facebook), Threads, X (Twitter), Reddit |
| Commerce | Shopify, Stripe, QuickBooks |
| Support | Zendesk |
| AI Providers | OpenAI, Claude, Gemini, DeepSeek, Grok, Mistral |
| Other | GDELT (news/events), OpenWeatherMap |
Connecting an Integration
The setup process varies by integration type but generally follows these steps:
OAuth-Based Integrations (Google, Microsoft, Slack, etc.)
- Navigate to the Integrations page.
- Find the integration card and click "Connect".
- You'll be redirected to the service's login page (e.g., Google Sign-In).
- Authorize Vantage to access your account.
- You'll be redirected back to Vantage with the integration connected.
API Key / Credentials Integrations (Databases, AI Providers, etc.)
- Navigate to the Integrations page or Settings → Add Credentials.
- Click "Connect" or "Add Credential".
- Enter the required credentials:
- Databases: Host, port, database name, username, password
- AI Providers: API key
- AWS S3: Access key ID, secret access key, region
- Stripe: API key
- Click "Save" or "Test Connection" to verify.
Managing Credentials
Viewing Credentials
Navigate to the Credentials page to see all saved credentials:
- Integration name and type
- Connection status (connected/disconnected)
- Last used date
Editing Credentials
- Click on an existing credential.
- Update the fields as needed.
- Click "Save".
Deleting Credentials
- Find the credential in the list.
- Click the delete icon.
- Confirm deletion.
Warning: Deleting a credential will break any workflows or dashboard tiles that depend on it.
Using Integrations in Dashboards
Once connected, integrations can be used as data sources for tiles:
- Create or edit a tile on your dashboard.
- In the data source settings, select the integration (e.g., "PostgreSQL — Production DB").
- Configure the query or data selection.
- The tile will display live data from the integration.
Using Integrations in Workflows
Integrations appear as nodes in the Workflow Editor:
- Open the Node Library in the Workflow Editor.
- Find the integration node (e.g., "Database Query", "Send Email", "Google Drive Read").
- Drag it onto the canvas.
- In the Properties Panel, select the credential to use.
- Configure the node-specific settings (query, file path, recipient, etc.).
Integration Settings (Domain Restrictions)
Organization admins can restrict which domains are allowed for integrations:
- Go to Settings → Organization → Integration Settings.
- Add allowed domains (e.g.,
*.company.com). - Only integrations from these domains will be permitted.
Troubleshooting
| Issue | Solution |
|---|---|
| Integration shows "Disconnected" | Re-authenticate by clicking "Reconnect" on the integration card. |
| OAuth redirect fails | Check that your browser allows popups and redirects. |
| Database connection timeout | Verify the host, port, and that your IP is whitelisted on the database server. |
| API key rejected | Ensure you're using the correct key and it has the necessary permissions. |
| Data not showing in tiles | Check the credential is still connected and the query/configuration is correct. |