Skip to main content

QuickBooks Online integration

Learn how to connect QuickBooks Online (QBO) to Turnstile, map your chart of accounts, and sync journal entries.

If QuickBooks Online (QBO) is enabled for your workspace, Turnstile can sync journal entries to QuickBooks Online. Learn more about the Accounting section.

Connect QuickBooks Online

To enable the QuickBooks Online integration in Turnstile:

  1. In Turnstile, head to Settings > Integrations.

  2. Click Connect next to the QuickBooks Online integration.

  3. Complete the QBO authorization flow.

  4. Return to Turnstile to confirm your connection.

Map your QBO chart of accounts to Turnstile

Account mapping links the accounts/categories Turnstile uses in journal entries to your QuickBooks Online chart of accounts. You will need to map any account you plan to use in journal entries.

  1. In Turnstile, go to Reporting > Accounting.

  2. Select Configure integration.

  3. Open the chart of accounts mapping.

  4. For each Turnstile account/category you use, select the matching QuickBooks Online account.

  5. Save changes.

Important: Mappings are required for successful sync. If a journal entry contains a line item tied to an unmapped account, that line item (and/or the journal entry) will not be able to sync until it is mapped.

Sync journal entries to QuickBooks Online

Turnstile supports syncing selected entries or all entries from the current view. Turnstile only syncs entries when you initiate the action.

Sync selected entries

  1. In Turnstile, go to Reporting > Accounting.

  2. Select one or more entries.

  3. Click Sync to QuickBooks Online.

Sync all entries

  1. In Turnstile, go to Reporting > Accounting.

  2. Apply any filters (for example, a month).

  3. Click Sync all (if available in your workspace).

Mark journal entries as synced

If you’ve already created or imported some entries in QuickBooks Online, outside of Turnstile, you can mark them as synced in Turnstile to keep your accounting view up to date, without pushing anything to QuickBooks.

Turnstile supports marking selected entries or all entries (from the current view) as synced:

1. In Turnstile, go to Reporting > Accounting.

2. Select one or more entries.

3. Click Mark as synced.

View QBO sync status in Turnstile

From Reporting > Accounting Turnstile labels each entry so you can track progress:

  • Pending: Shows all items ready to sync but not yet posted to QuickBooks Online.

  • Synced: Shows items successfully posted to QuickBooks Online or manually marked as synced.

  • Syncing: Line item will be marked with a loading indicator while it’s actively being synced, and will stay in Pending until it’s synced successfully.

  • Failed: If a line item couldn’t be synced, Turnstile shows a reason so you can fix it. It will stay in Pending until it’s synced successfully.

Correct an unsynced journal entry

If a journal entry includes a line item tied to an unmapped account:

  • The entry will not sync successfully.

  • Turnstile will mark the item as Failed (or show a sync error state).

  • Turnstile will display a reason so you know what needs to be mapped or corrected.

To fix an unsynced entry that failed due to the account not being mapped:

Head to Reporting > Accounting > Configure integration and add/correct mapping.

After you fix the mapping, you can re-sync the affected entries from Reporting > Accounting.

Did this answer your question?