API reference · QuickBooks v1
POST/api/v1/integrations/quickbooks/oauth/callback

Handle QuickBooks OAuth callback payload

Consumes OAuth callback payload with code/state/realm and persists connection tokens. Both /api/v1/integrations/quickbooks/* and /api/v1/quickbooks/* map to the same ApiQuickBooksController method (handleOAuthCallback). 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 QuickBooksV1OAuthCallbackBody

codestringRequired
min length 1
statestringRequired
min length 1
realmIdstringRequired
min length 1
errorstring
error_descriptionstring

Response body

Success response 200 · schema QuickBooksV1ApiSuccess

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

Response codes

200
QuickBooks operation succeeded.
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.