API reference›Connection setup›Put Setup Account Mappings
104 operations ↓ OpenAPI JSON Get API key
PUT /v1/setup/connections/{connection_id}/account-mappings

Put Setup Account Mappings

Submit KMU default account-mapping selection or reviewed overrides.

Requires setup token Idempotent OpenAPI v1

Authentication

Used only by one approved onboarding connection for setup facts and first-key creation. Normal source-fact and accounting endpoints require a HelvCore API key.

GETHeader
Authorization: Bearer hv1_setup_...

Parameters

Idempotency-Keystringrequiredheader

Documented field.

connection_idstringrequiredpath

Documented field.

Request body

Send JSON using the documented schema. Unknown or unsafe fields fail with structured validation errors where the endpoint owns validation.

use_kmu_defaultsbooleanoptionalbody

Documented field.

overridesarrayoptionalbody

Documented field.

Returns

Returns a documented JSON response on success and the standard HelvCore error envelope on failure.

202Successful response.
defaultStructured error response.
401invalid_auth - missing, expired, or invalid Bearer key

Stable error codes

idempotency_key_conflictDocumented HelvCore error code for this operation.
invalid_or_expired_access_tokenDocumented HelvCore error code for this operation.
invalid_requestDocumented HelvCore error code for this operation.
missing_idempotency_keyDocumented HelvCore error code for this operation.
validation_failedDocumented HelvCore error code for this operation.