---
title: "Commit exact personal-account classifications and release one sync"
method: POST
path: "/onboarding/v3/banks/commit"
tags: ["Onboarding"]
---

# Commit exact personal-account classifications and release one sync

`POST /onboarding/v3/banks/commit`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/onboarding/v3/banks/commit`
- Auth: HTTP bearer

The account set must exactly match the live held integration. Identical replays are idempotent; changed replays remain locked.

## Headers

- `X-Median-App-Surface` 'qa'

## Request body

- OnboardingV3PlaidCommitRequest: Every live account must appear once, and at least one account must remain in the business books.
  - `integrationId` string, uuid, required
  - `accounts` OnboardingV3PlaidAccountClassification[], required
    - `bankAccountId` string, uuid, required
    - `isPersonal` boolean, required

## Response `200`

Committed account projection and initial sync job, if newly released

- OnboardingV3PlaidCommitApiResponse
  - `success` true, required
  - `data` OnboardingV3PlaidCommit, required
    - `integrationId` string, uuid, required
    - `accounts` OnboardingV3PlaidAccount[], required
      - `bankAccountId` string, uuid, required
      - `name` string, required
      - `type` 'checking' | 'savings' | 'credit' | 'investment', nullable, required
      - `mask` string, nullable, required
      - `balanceCents` integer, nullable, required
      - `currency` string, required
      - `institutionName` string, required
      - `isPersonal` boolean, required
    - `syncJobId` string, uuid, nullable, required

## Other responses

- `400`: Onboarding request body is not valid JSON
- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `409`: Request conflicts with the durable onboarding state
- `413`: Onboarding setup request exceeds the 32768-byte route limit
- `415`: Onboarding request charset or content encoding is unsupported
- `422`: Validation error
- `503`: Required sandbox provider configuration or service 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)