v5

latestOpenAPI 3.0.02026-08-044441026.8 MB
Integrations

Import a partner-supplied OAuth connection

Register a QuickBooks or Xero connection using OAuth tokens the partner obtained directly from the provider. Pair with the partner integration credentials configured by support.

post/integrations/{integration}/connection

Path parameters

integrationstring required

Request body

business_entity_idstring required
access_tokenstring required

OAuth access token issued by the partner's QBO/Xero app for the customer.

access_token_expires_innumber required

Lifetime of the access token, in seconds.

refresh_tokenstring required

Long-lived refresh token paired with the access token.

refresh_token_expires_innumber required

Lifetime of the refresh token, in seconds.

realm_idstring

QuickBooks company id (QBO realmId). Required for QuickBooks, ignored for Xero.

Response

OK

idstring

The unique identifier of the object in Nmbr.

objectstring

The type of the object in Nmbr ("integration").