Skip to main content
POST
Register an AWS account

Authorizations

Authorization
string
header
required

API key from Settings → Security → API Keys. Pass as Authorization: Bearer YOUR_API_KEY.

Headers

Idempotency-Key
string
required

Unique key for safe retries on write requests (required, max 64 characters).

Maximum string length: 64

Body

application/json

JSON request body

Response

Registers one new AWS payer account and runs the Savings Analysis permission check. Used by the Clara Terraform provider after it creates the IAM role. Requires aws-onboarding:create, which this endpoint accepts and no other endpoint does: a key with only that permission cannot read, change, or delete anything. Returns 409 when the account already has an integration, with no detail about it. verification.state is verified, partial (Savings Analysis checks failed but cost and usage ingest works), failed, or unavailable (the check could not run; verify in the Clara UI).

error
object
required