# Start an acumatica oauth connect

> POST /connections/acumatica/oauth/authorize

Source: https://docs.trykintsugi.com/reference/2026-07-21/start-an-acumatica-oauth-connect

POST /connections/acumatica/oauth/authorize

Start an acumatica oauth connect

Return the Acumatica consent URL for the resolved organization's self-hosted instance. `clientId`/`clientSecret` are the OAuth app registered on that instance; never echoed back. A multi-org credential must send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector, or gets a 400. Call this from a browser with credentials (cookies) included: the callback that finishes the connect is bound to the session cookie this response sets, so it only completes for the same browser.

Category: Connections

Request body:
instanceUrl (string, required) - Acumatica instance base URL.
clientId (string, required) - Acumatica OAuth client id.
clientSecret (string, required) - Acumatica OAuth client secret.
endpointVersion (string) - Acumatica contract endpoint version.
endpointName (string) - Acumatica contract endpoint name.
branchId (string) - Optional branch scope applied after OAuth.

Response fields:
authUrl (string, required) - Consent URL to redirect the user to.

Response statuses: 200, 400, 401, 403, 404, 409, 422

---

Index of every page: https://docs.trykintsugi.com/llms.txt