> For the complete documentation index, see [llms.txt](https://help.digits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.digits.com/business-connections/how-connections-work.md).

# How Connections Work

A connection is the link between Digits and an external financial account or service. It allows Digits to automatically import and keep your financial data up to date.

***

### Types of Connections

{% columns %}
{% column %}
**Bank and Card Connections (via Plaid)**

These connect directly to financial institutions like Chase or Bank of America.

Each login creates one connection, which can include multiple accounts, such as checking, savings, or credit cards.
{% endcolumn %}

{% column %}
**App Connections**

These connect to tools like Gusto (payroll), Stripe (invoices and payments), Ramp (cards), or BILL (bills and invoices).

They use each app’s own authorization flow and may behave differently from bank connections.
{% endcolumn %}
{% endcolumns %}

***

### Connections vs. Accounts

A connection and an account are not the same:

* A **connection** is the top-level link to an institution or service (for example, Chase)
* An **account** is an individual account within that connection (for example, a checking account or credit card)

A single connection can include multiple accounts.

{% hint style="info" %}
**Tip:** If you only need to remove or manage one account, you don’t need to remove the entire connection.
{% endhint %}

***

### Connections Belong to One Entity

Every connection lives inside a single entity (business). If you have more than one entity in your organization, each one has its own connections. Add each bank or app from inside the entity it belongs to. Connections aren't shared between entities, and the same bank can be connected in more than one entity if each entity has its own account there.

To open an entity, click your organization name in the upper left and select it, or choose **View All Entities**. See [Multi-Entity: Run Several Businesses Under One Account](https://help.digits.com/my-business-account/add-additonal-businesses.md)

***

### How Data Flows In

When you create a connection, you choose a start date. Digits imports transactions from that date forward and continues syncing automatically.

If you set a Digits start date when you migrated from QuickBooks, Xero, or another platform, new connections use it automatically. You can change an individual connection's start date at any time. See [Change the Start Date for a Connection](https://help.digits.com/business-connections/start-date.md)

For bank and card connections, you may occasionally need to re-authorize through your bank. This is expected and helps keep the connection active.

***

### Connection Statuses

<table data-search="false"><thead><tr><th width="270.7613525390625">Status</th><th>What it means</th></tr></thead><tbody><tr><td><strong>Connected</strong></td><td>Syncing normally</td></tr><tr><td><strong>Connecting</strong></td><td>Initial setup or just re-authenticated (may take a few minutes)</td></tr><tr><td><strong>Initial Sync In Progress</strong></td><td>Waiting for the bank or service to finish adding accounts</td></tr><tr><td><strong>Disconnected</strong></td><td>Your bank requires you to log in again to resume syncing</td></tr><tr><td><strong>Failed</strong></td><td>Digits stopped syncing after repeated errors; reconnect to resume.</td></tr><tr><td><strong>Re-authentication required</strong></td><td>A specific re-authorization is needed (distinct from fully disconnected)</td></tr><tr><td><strong>Setup Incomplete</strong></td><td>Category mappings or activation steps need to be finished</td></tr><tr><td><strong>Awaiting accountant</strong></td><td>Setup is pending your accountant finalizing the connection. (This status only applies if your business is managed by an accounting firm.)</td></tr><tr><td><strong>Delayed Syncing</strong></td><td>Sync is behind. Digits is working on catching it up</td></tr><tr><td><strong>Archived</strong></td><td>Permanently disconnected; no new data will import</td></tr></tbody></table>

***

### QuickBooks is Not a Connection

QuickBooks works differently from other connections in Digits.

When you connect QuickBooks during setup, Digits imports your historical data up to your Digits start date. This is a one-time import, not an ongoing sync.

After setup is complete, QuickBooks is no longer connected.

See: [Migrate Data from QuickBooks Online](https://help.digits.com/business-getting-started/migrate-from-quickbooks.md)

***

**Related articles**

* [Change the Start Date for a Connection](https://help.digits.com/business-connections/start-date.md)
* [Delete or Remove Transactions in Digits](https://help.digits.com/business-connections/remove-transactions.md)
* [Archive and Delete a Connection](https://help.digits.com/business-connections/remove-connections.md)
* [Starting Over in Digits](https://help.digits.com/business-connections/starting-over.md)

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears—come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://portal.usepylon.com/digits/forms/get-in-touch-with-digits-support" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.digits.com/business-connections/how-connections-work.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
