Skip to main content
POST
Provision embedded wallet

Authorizations

Authorization
string
header
required

Cognito JWT token for regular user authentication

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.