---
title: "Approve QuickBooks account to Median GL account mappings (#2642)"
method: POST
path: "/accountant/companies/{customerId}/integrations/quickbooks/account-mappings"
tags: ["Accountants"]
---

# Approve QuickBooks account to Median GL account mappings (#2642)

`POST /accountant/companies/{customerId}/integrations/quickbooks/account-mappings`

## Request

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

Each mapping supersedes the account's current mapping. Accounts must come from the latest completed QuickBooks read; GL accounts must be active accounts of the customer. `cashSource` defaults to `quickbooks` (QBO's own feed brings that account's cash, so Median never posts it back).

## Request body

- object
  - `mappings` object[], required
    - `qboAccountId` string, required
    - `glAccountId` string, uuid, required
    - `cashSource` 'quickbooks' | 'median'

## Response `200`

The recorded mappings

- object
  - `success` true, required
  - `data` object, required
    - `mappings` QuickBooksAccountMapping[], required
      - `id` string, uuid, required
      - `companyId` string, uuid, required
      - `entityId` string, uuid, required
      - `connectionId` string, uuid, required
      - `realmId` string, required
      - `qboAccountId` string, required
      - `sourceObjectId` string, uuid, required
      - `glAccountId` string, uuid, required
      - `cashSource` 'quickbooks' | 'median', required
      - `approvedByUserId` string, uuid, required
      - `supersedesId` string, uuid, nullable, required
      - `createdAt` string, date-time, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `409`: A mapping changed concurrently
- `422`: Validation error, unknown QuickBooks account, invalid GL account, or no completed QuickBooks read

---

[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)