KintsugiKintsugi
API reference / Connect the kintsugi xero app

Connect the kintsugi xero app

POST/connections/xero/{conn_id}/oauth/authorize-request

Return the Xero consent URL that adds tax write-back on an existing Xero connection. The organisation the user authorizes must be the same one the sync already uses. Call this from a browser with credentials included: the callback is bound to the session cookie this response sets.

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.

Path parameters

conn_idstringRequired

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.

503

A service this request depends on was unavailable. Retry the request.

cURL
POST /connections/xero/{conn_id}/oauth/authorize-request
-H "Api-Key: ***"
-H "Api-Version: 2026-10-06"
Example request
https://api.trykintsugi.com/connections/xero/{conn_id}/oauth/authorize-request
Response
{
"authUrl": "https://www.example.com"
}
Connect the kintsugi xero app (2026-10-06) | Kintsugi API Reference