POST /v1/setup/connections/{connection_id}/api-keys

Create First Api Key

Create the first named API key after approval. The full key is returned once.

Requires setup token 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

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.

key_namestringrequiredbody

Documented field.

environmentenum<production | sandbox>optionalbody

Documented field.

expires_in_daysintegeroptionalbody

Documented field.

Returns

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

201Successful response.

defaultStructured error response.

401invalid_auth - missing, expired, or invalid Bearer key

Stable error codes

invalid_or_expired_access_tokenDocumented HelvCore error code for this operation.

invalid_requestDocumented HelvCore error code for this operation.

validation_failedDocumented HelvCore error code for this operation.