KintsugiKintsugi
API reference / Validate zuora credentials

Validate zuora credentials

POST/connections/zuora/validate

Validate Zuora OAuth client credentials and list the tenant's entities for the connect dropdown. Single-entity tenants return multiEntityEnabled=false with no entities. Returns 400 if the credentials are invalid.

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

clientIdstringRequired

Zuora OAuth client id.

clientSecretstringRequired

Zuora OAuth client secret.

baseUrlstring

Zuora API base URL; defaults to the US production URL.

Response

multiEntityEnabledbooleanRequired

Whether this Zuora tenant is Multi-Entity.

entitiesZuoraEntity[]

Entities available for a Multi-Entity tenant.

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.

422

The request failed validation.

cURL
POST /connections/zuora/validate
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"clientId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"clientSecret": "********",
"baseUrl": "https://www.example.com"
}
Response
{
"multiEntityEnabled": false,
"entities": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"name": "Acme Corp",
"displayName": "Acme Corp",
"status": "ACTIVE"
}
]
}
Validate zuora credentials (2026-07-21) | Kintsugi API Reference