Connections

OAuth Callback

Completes the OAuth authorization flow after provider redirect. Exchanges the authorization code for tokens, stores them, and triggers an initial sync. This is a redirect target — not typically called directly. QuickBooks: only the company that built the graph's books may connect to them; another company is refused (409 OTHER_COMPANY_BOOKS) before any token is issued. Plaid: pass Link's public_token as code; a bank already connected to the graph is refused (409 DUPLICATE_BANK_CONNECTION).

post/v1/graphs/{graph_id}/connections/oauth/callback/{provider}

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/v1/graphs/{graph_id}/connections/oauth/callback/{provider}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

providerstring required

OAuth provider name

graph_idstring required

Request body

codestring required

Authorization code from the OAuth provider (Plaid: the public_token Link returned)

statestring required

OAuth state for verification

realm_idstring nullable

QuickBooks-specific realm ID

errorstring nullable

OAuth error if authorization failed

error_descriptionstring nullable

OAuth error details

Response

Successful Response

successboolean required

Whether the connection was established

messagestring required

Human-readable outcome of the exchange

connection_idstring required

Connection the authorization was linked to

auto_sync_task_idstring nullable

Task id of the initial sync started after connecting, or null when no sync was kicked off

Changes

No recorded changes to this operation across all 1 revision of this API.