Skip to main content
GET
OAuth callback for accounting providers

Path Parameters

Query Parameters

This endpoint is called automatically by the OAuth provider after the user authorizes the connection. You should not call this endpoint directly. Use the Initiate Accounting OAuth endpoint to start the flow.

Example Request

Response

On success, the user is redirected to the redirect_uri specified in the original connect request with a success=true query parameter.

Notes

  • Recurso handles the token exchange automatically using the authorization code.
  • If the state parameter does not match the original request, the callback returns a 403 error.
  • On failure, the user is redirected with success=false and an error query parameter describing the issue.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Path Parameters

provider
enum<string>
required

Accounting provider.

Available options:
quickbooks,
xero

Query Parameters

code
string
required
state
string
required

HMAC-signed state issued by the connect endpoint.

realmId
string

QuickBooks company (realm) ID.

Response

Redirect to the dashboard Integrations page carrying the outcome as a query param (connected or error).