---
title: "Queue a fresh read of the customer's verified QuickBooks realm (#2821)"
method: POST
path: "/accountant/companies/{customerId}/integrations/quickbooks/source-sync"
tags: ["Accountants"]
---

# Queue a fresh read of the customer's verified QuickBooks realm (#2821)

`POST /accountant/companies/{customerId}/integrations/quickbooks/source-sync`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/integrations/quickbooks/source-sync`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Only queues the read; the source-sync worker reads QuickBooks, then auto-map and automatic posting run as after the daily re-read. Refuses with 422 QUICKBOOKS_SOURCE_SYNC_DISABLED while QUICKBOOKS_SOURCE_SYNC_ENABLED is off.

## Response `200`

Queued source-read status; the active run when one is already queued or running

- object
  - `success` true, required
  - `data` QuickBooksSourceStatus, required
    - `connectionId` string, uuid, required
    - `sourceRunId` string, uuid, nullable, required
    - `state` 'disabled' | 'connected_no_import' | 'importing' | 'source_ready' | 'failed' | 'stale', required
    - `latestAttemptAt` string, date-time, nullable, required
    - `lastSuccessfulSourceReadAt` string, date-time, nullable, required
    - `objectsSeen` integer, required
    - `byType` object, required
    - `glPostingState` 'pending_mapping_and_reconciliation', required
    - `errorCode` string, nullable, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `422`: QuickBooks is not connected or needs reauthorizing (QUICKBOOKS_LEDGER_NOT_CONNECTED, QUICKBOOKS_LEDGER_NEEDS_REAUTH), the connection changed, or source sync is switched off (QUICKBOOKS_SOURCE_SYNC_DISABLED, POST only)
- `503`: Source sync or the provider is unavailable

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)