Skip to main content
POST
Provision embedded wallet

Authorizations

Authorization
string
header
required

User bearer credential: either a Cognito JWT or an ak_ user API key. Backend integrators using HMAC must include the user API key alongside the three HMAC headers on user-scoped endpoints.

Body

Request body for provisioning an embedded wallet.

Request body for provisioning an embedded wallet.

challenge
string
required

Passkey/WebAuthn challenge produced by the client SDK. Forwarded directly to Turnkey to bind the user's authenticator to the new sub-organization.

Minimum string length: 1

Response

Wallet status envelope for an active (provisioned) wallet. The only response shape returned by POST /v1/wallet-kit.

Wallet status envelope for an active (provisioned) wallet. The only response shape returned by POST /v1/wallet-kit.

status
enum<string>
required

An embedded wallet has been provisioned for this user.

Available options:
active
data
object
required

An embedded wallet for the authenticated user. Backed by a Turnkey sub-organization that holds the user's keys.