---
title: "Queue a fresh read of the verified QBO realm; no GL posting"
method: POST
path: "/companies/{companyId}/integrations/quickbooks/source-sync"
tags: ["Integrations"]
---

# Queue a fresh read of the verified QBO realm; no GL posting

`POST /companies/{companyId}/integrations/quickbooks/source-sync`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/integrations/quickbooks/source-sync`
- Auth: HTTP bearer

## Response `200`

Queued source-read status

- 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`: The verified QuickBooks connection is unavailable or changed
- `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)