Update Payment Type Mapping
PUT/api/qbo/payment-type-mappings/:paymentTypeId
Maps a payment type to a QBO bank account. Pass null for qbo_account_id to clear the mapping.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Requires the accounting.manage_settings permission.
The account must be an active Bank or Credit Card account of the connected QuickBooks company. An account that is inactive in QuickBooks is refused with 422 (error: "Inactive QBO account") because QuickBooks would reject payments posted to it — reactivate it in QuickBooks and sync accounts, or choose an active account. Existing mappings to accounts made inactive later are left as they are.
Request
Responses
- 401
- 403
- 404
- 422
- 429
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.