API reference · QuickBooks v1
POST/api/v1/integrations/quickbooks/mappings

Create data mapping

Creates one data mapping configuration; current implementation returns synthetic mapping id. Both /api/v1/integrations/quickbooks/* and /api/v1/quickbooks/* map to the same ApiQuickBooksController method (createDataMapping). This family uses route handlers that instantiate ApiQuickBooksController and usually wrap calls in explicit try/catch handleApiError blocks.

RBAC · quickbooks

Request body

Content type: application/json · schema QuickBooksV1DataMappingBody

entity_typestringRequired
Enum: customerinvoicepaymentitemtax_code
mapping_namestringRequired
field_mappingsarray of objectRequired
min items 1
itemsobject
alga_fieldstringRequired
qbo_fieldstringRequired
transform_functionstring
is_requiredboolean
default_valueany
validation_rulestring
is_defaultboolean
descriptionstring

Response body

Success response 201 · schema QuickBooksV1ApiSuccess

dataanyOfRequired
anyOf (option 1)object
anyOf (option 2)array of object
itemsobject
metaobject

Response codes

201
Mapping created.
400
Validation or request parsing failure.
401
API key missing/invalid or associated user missing.
403
QuickBooks RBAC permission denied.
500
Unexpected QuickBooks endpoint failure.