Setting Up an Integration
Overview
The integration detail page allows you to connect or disconnect a specific third-party application with your Aurora Inbox account. Connections are established through a secure authorization flow that opens a popup window to authenticate with the external provider. You can also disconnect an existing integration from this page.
How to Access
- Navigate to Sidebar > Tools > Integrations, then click on an integration card
- Required role: Channels Administrator
Interface Overview
The detail page contains:
- A header section showing the integration icon, name, and connection status (green "Connected" badge if active)
- A Connect button (shown when the integration is not connected)
- A Disconnect button (shown when the integration is connected)
- A back button to return to the integrations list
- A content area below the header that loads integration-specific configuration (e.g., Facebook Lead Ads form mapping)
Features & Actions
Connect an Integration
What it does: Initiates an authorization flow with the external provider. A popup window opens where you authenticate and grant Aurora Inbox access to the external service.
Steps:
- Navigate to the integration detail page
- Click the Connect button
- A popup window opens with the external provider's login/authorization page
- Sign in and authorize Aurora Inbox to access your account on the external platform
- Once authorization is complete, the popup closes automatically
- The integration status updates to "Connected" and a green badge appears
Important notes:
- Make sure your browser allows popup windows for the Aurora Inbox domain
- The connection is established via a secure authorization flow; Aurora Inbox never sees your external account password
- After successful connection, the page automatically refreshes to show the updated status
Disconnect an Integration
What it does: Removes the connection between Aurora Inbox and the external service. Any features that depend on this integration will stop working.
Steps:
- Navigate to the integration detail page for a connected integration
- Click the Disconnect button (red)
- A confirmation dialog appears
- Click Disconnect in the dialog to confirm, or Close to cancel
- The connection is removed and the status updates
Important notes:
- Disconnecting an integration removes the connection with the external service
- Any lead form connections, synced data, or automation that depends on this integration will stop functioning
- You can reconnect the integration at any time by clicking Connect again
- The disconnect action cannot be undone -- you will need to re-authorize the integration to reconnect
Fields Reference
| Field | Description | Required | Notes |
|---|---|---|---|
| Integration Name | Display name of the third-party app | -- | Read-only, shown in header |
| Connection Status | Whether the integration is connected | -- | Shows green "Connected" badge or Connect button |
Important Notes
- Only users with the Channels Administrator role can connect or disconnect integrations
- The connection is established through a secure authorization flow with the external provider
FAQ
Q: The popup window was blocked by my browser. What should I do? A: Enable popups for the Aurora Inbox domain in your browser settings and try again.
Q: I connected the integration but it still shows as disconnected. What happened? A: The authorization in the popup may not have completed. Try again and make sure to complete the full authorization flow in the popup window before closing it.
Q: Will disconnecting an integration delete my data? A: Disconnecting removes the connection, but data previously imported (such as leads or contacts) is retained. However, no new data will be synced.
Q: Can I connect the same integration with multiple accounts? A: Each integration supports one active connection per Aurora Inbox account.