KintsugiKintsugi

Start an acumatica oauth connect

POST/connections/acumatica/oauth/authorize

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.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

instanceUrlstringRequired

Acumatica instance base URL.

clientIdstringRequired

Acumatica OAuth client id.

clientSecretstringRequired

Acumatica OAuth client secret.

endpointVersionstring

Acumatica contract endpoint version.

endpointNamestring

Acumatica contract endpoint name.

branchIdstring

Optional branch scope applied after OAuth.

Response

authUrlstringRequired

Consent URL to redirect the user to.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
POST /connections/acumatica/oauth/authorize
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"instanceUrl": "https://www.example.com",
"clientId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"clientSecret": "********",
"endpointVersion": "25.200.001",
"endpointName": "Default",
"branchId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10"
}
Response
{
"authUrl": "https://www.example.com"
}
Start an acumatica oauth connect (2026-07-21) | Kintsugi API Reference