PUT /v1/setup/connections/{connection_id}/fiscal-year

Put Setup Fiscal Year

Submit fiscal-year setup facts for an approved connection.

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.

labelstringrequiredbody

Documented field.

period_startstringrequiredbody

Documented field.

period_endstringrequiredbody

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.