Connect Your First Data Source
Resplendent Data needs something to pull from. This guide walks you through connecting your first integration—whether that’s a PSA tool, accounting software, or a database.
Pick your source type
Section titled “Pick your source type”| Source type | Examples | Notes |
|---|---|---|
| Cloud app | ConnectWise, Autotask, QuickBooks Online, HaloPSA | Most common. Connects via API. |
| Database | PostgreSQL, MySQL, SQL Server | Direct connection. Requires whitelisting our IPs. |
| On-premise | QuickBooks Desktop, local SQL Server | Requires installing our Sync Agent on your server. |
Connecting a cloud app
Section titled “Connecting a cloud app”This covers tools like ConnectWise, Autotask, or QuickBooks Online.
Step 1: Go to Data Settings
Section titled “Step 1: Go to Data Settings”- Log in to Resplendent Data
- Click Data Settings in the sidebar
- Select Integrations
Step 2: Find and connect your service
Section titled “Step 2: Find and connect your service”- You’ll see a gallery of supported integrations
- Find your app (e.g., “ConnectWise”) and click Connect on the card
Step 3: Authenticate
Section titled “Step 3: Authenticate”You’ll see one of two screens depending on the service:
OAuth (QuickBooks Online, Google Sheets, etc.)
- Click Connect with [Service Name]
- A popup opens—log in with your credentials for that service
- Click Authorize or Allow
- The popup closes and you’re connected
API Keys (ConnectWise, Autotask, HaloPSA)
- You’ll see a form asking for credentials (Public Key, Private Key, etc.)
- Generate these keys inside the other application
- Need help? See the specific guides:
- Enter the keys and click Save & Test
Step 4: Open the dataset editor
Section titled “Step 4: Open the dataset editor”Once the connection test passes, a Sync Dataset button appears in the dialog. Click it to open the Dataset Editor.
Step 5: Select a dataset and columns
Section titled “Step 5: Select a dataset and columns”The Dataset Editor has two panels:
- Right panel: A scrollable list of all available tables from your integration (Tickets, Invoices, Companies, etc.)
- Left panel: Shows the columns for whichever dataset you select
To add a dataset:
- Click a dataset name in the right panel to select it
- In the left panel, use the checkboxes to choose which columns to include (there’s a “Select All” option at the top)
- Optionally give the dataset a custom label
- Click Save & Close to start the sync
Repeat for each dataset you want to sync. Start simple—pick your most important data (Tickets, Invoices) to keep the initial sync fast. You can always add more datasets later.
Detailed setup guides
Section titled “Detailed setup guides”For step-by-step API key instructions:
PSA & ITSM
Accounting
Databases
Databases and on-premise sources
Section titled “Databases and on-premise sources”Database connections
Section titled “Database connections”Connecting a database requires whitelisting our IP addresses and providing read-only credentials. See the Database Connection Guide.
On-premise agents
Section titled “On-premise agents”For QuickBooks Desktop or local SQL servers behind a firewall, you’ll need a Sync Agent running on your network:
- Go to Data Settings → Sync Agents
- Create a new agent and copy the credentials
- Install the agent on a Linux server (or any machine with Docker)
- Follow the QuickBooks Desktop On-Premise Setup for the full walkthrough
What happens after you save a dataset
Section titled “What happens after you save a dataset”Your dataset appears in the Datasets list with a status:
- Initializing — Setting up the connection
- Syncing — Downloading your historical data
- Active — Done! Data is ready to use.
How long does it take?
Section titled “How long does it take?”- Small accounts: A few minutes
- Large accounts (10+ years of data): 1-4 hours for the initial pull
Refresh rates
Section titled “Refresh rates”After the initial sync, data updates automatically:
| Tier | Refresh rate |
|---|---|
| Free Forever | 60 minutes (or manual) |
| Starter | Every 15 minutes |
| Professional+ | Every 60 seconds |
Next steps
Section titled “Next steps”Data flowing? Time to build your first dashboard.