# Connect a vertex o-series account

> POST /connections/vertex-o-series/connect

Source: https://docs.trykintsugi.com/reference/2026-07-21/connect-a-vertex-o-series-account

POST /connections/vertex-o-series/connect

Connect a vertex o-series account

Create or update a Vertex O-Series connection for a partition, using either Basic Auth (`username`/`password`) or O Series Cloud OAuth (`clientId`/`clientSecret` + `partitionUuid`). Re-submitting the same `trustedId` updates its stored credentials rather than creating a second connection. Returns 400 if the credentials are invalid, or the auth fields do not form one complete auth mode. No separate validate route exists for Vertex O-Series. A multi-org credential must send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector, or gets a 400.

Category: Connections

Request body:
trustedId (string, required) - Vertex Trusted ID for the partition.
username (string) - Integration username (Basic Auth).
password (string) - Integration password (Basic Auth).
clientId (string) - O Series Cloud OAuth client id.
clientSecret (string) - O Series Cloud OAuth client secret.
partitionUuid (string) - O Series Cloud partition UUID; required for OAuth connect.
reportingClientId (string) - Solution Reporting API client id.
reportingClientSecret (string) - Solution Reporting API client secret.
backfillStartDate (string) - Optional ISO date (YYYY-MM-DD) for historical backfill.
reportDefinitionId (string) - Optional Transaction Detail Extract report definition UUID.
soapInstanceUrl (string) - Client Utilities base for Tax Journal sync (SOAP).
restInstanceUrl (string) - REST base for health checks (vertex-ws).
instanceUrl (string) - Legacy single URL; inferred as SOAP or REST from its shape.
name (string) - Display name; defaults to the trusted id.

Response fields:
id (string, required) - Kintsugi's unique identifier for the connection.
organizationId (string, required) - Id of the organization this connection belongs to.
platformEntityId (string) - The platform's own identifier for the entity this connection points at (e.g. a QuickBooks realm id, D365 company id, NetSuite subsidiary id). Use it to resolve a connection from an id you already hold. `null` until captured on (re)connect or backfilled.
externalId (string, required) - The connection's own external identifier: an Apideck consumer id for a Vault-backed source, or the platform-specific value the connector stores (e.g. a Shopify shop id, a Stripe publishable key).
[truncated, see the reference page]

---

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