> ## Documentation Index > Fetch the complete documentation index at: https://developers.circle.com/llms.txt > Use this file to discover all available pages before exploring further. # Create wallets > Generates a challenge to create a new user-controlled wallet or a batch of wallets. You must specify the blockchain and wallet name. ## OpenAPI ````yaml openapi/user-controlled-wallets.yaml post /v1/w3s/user/wallets openapi: 3.0.3 info: version: '1.0' title: User-Controlled Wallets description: User-Controlled Wallets API documentation. servers: - url: https://api.circle.com security: - BearerAuth: [] tags: - name: Social/ Email Authentication - name: PIN Authentication - name: Users - name: Wallets - name: Transactions - name: Token Lookup - name: Signing paths: /v1/w3s/user/wallets: post: tags: - Wallets summary: Create wallets description: >- Generates a challenge to create a new user-controlled wallet or a batch of wallets. You must specify the blockchain and wallet name. operationId: createUserWallet parameters: - $ref: '#/components/parameters/XUserToken' - $ref: '#/components/parameters/XRequestId' requestBody: $ref: '#/components/requestBodies/CreateEndUserWallet' responses: '200': content: application/json: schema: $ref: '#/components/schemas/CreateEndUserWallet' description: >- Returns the existing challenge if the idempotency key matches a previous successful request. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' '201': content: application/json: schema: $ref: '#/components/schemas/CreateEndUserWallet' description: Successfully created the challenge to create the wallets. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' security: - BearerAuth: [] components: parameters: XUserToken: name: X-User-Token description: Unique system generated JWT session token for specific user. required: true in: header schema: type: string XRequestId: name: X-Request-Id in: header description: > Developer-provided identifier for this request, used for tracing requests in Wallets API logs and the Developer Console, and when communicating with Circle Support. **Must be a UUID to appear in logs.** Non-UUID values are accepted by the API but are ignored by logging and tracing systems. schema: $ref: '#/components/schemas/XRequestId' requestBodies: CreateEndUserWallet: content: application/json: schema: title: CreateEndUserWalletRequest type: object required: - blockchains - idempotencyKey properties: idempotencyKey: $ref: '#/components/schemas/IdempotencyKey' accountType: $ref: '#/components/schemas/AccountType' blockchains: type: array description: Blockchain(s) the requested wallets will be created on. items: $ref: '#/components/schemas/Blockchain' metadata: type: array description: >- List of metadata fields to associate with the corresponding wallet. items: $ref: '#/components/schemas/WalletMetadata' description: walletResponse creation request required: true schemas: CreateEndUserWallet: title: CreateEndUserWalletResponse type: object properties: data: type: object required: - challengeId properties: challengeId: $ref: '#/components/schemas/ChallengeId' XRequestId: type: string format: uuid description: >- A unique identifier, which can be helpful for identifying a request when communicating with Circle support. example: 2adba88e-9d63-44bc-b975-9b6ae3440dde IdempotencyKey: type: string description: >- Universally unique identifier (UUID v4) idempotency key. This key is utilized to ensure exactly-once execution of mutating requests. To create a UUIDv4 go to [uuidgenerator.net](https://www.uuidgenerator.net). If the same key is reused, it will be treated as the same request and the original response will be returned. example: a0eebc99-9c0b-4ef8-bb6d-6bb9bd380a11 format: uuid AccountType: type: string description: > An account can be a Smart Contract Account (SCA) or an Externally Owned Account (EOA). To learn more, see the [account types guide](https://developers.circle.com/wallets/account-types). If an account type is not specified during the creation of a wallet, it defaults to `EOA` (Externally Owned Account). Note that Solana and Aptos don't support Smart Contract Account (SCA). enum: - SCA - EOA Blockchain: type: string description: >- The blockchain network that the resource is to be created on or is currently on. enum: - ETH - ETH-SEPOLIA - AVAX - AVAX-FUJI - MATIC - MATIC-AMOY - SOL - SOL-DEVNET - ARB - ARB-SEPOLIA - NEAR - NEAR-TESTNET - EVM - EVM-TESTNET - UNI - UNI-SEPOLIA - BASE - BASE-SEPOLIA - OP - OP-SEPOLIA - APTOS - APTOS-TESTNET - ARC-TESTNET - MONAD - MONAD-TESTNET example: MATIC-AMOY WalletMetadata: type: object properties: name: $ref: '#/components/schemas/Name' refId: $ref: '#/components/schemas/ReferenceId' ChallengeId: type: string format: uuid description: >- Unique system generated identifier used to initiate a user challenge flow. example: c4d1da72-111e-4d52-bdbf-2e74a2d803d5 Name: type: string description: Name or description associated with the wallet or walletSet. ReferenceId: type: string description: >- Optional user-defined reference identifier for the wallet. Not used by Circle for wallet functionality. Used for internal tracking or associating wallets with entities in your own systems (for example, a customer or account ID). example: customer_12345 headers: XRequestId: description: > Developer-provided header parameter or Circle-generated universally unique identifier (UUID v4). Useful for identifying a specific request when communicating with Circle Support. schema: $ref: '#/components/schemas/XRequestId' responses: BadRequest: content: application/json: schema: type: object title: BadRequestResponse required: - code - message properties: code: type: integer description: Code that corresponds to the error. message: type: string description: Message that describes the error. example: code: 400 message: Bad request. description: Request cannot be processed due to a client error. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' NotAuthorized: content: application/json: schema: type: object title: NotAuthorizedResponse required: - code - message properties: code: type: integer description: Code that corresponds to the error. message: type: string description: Message that describes the error. example: code: 401 message: Malformed authorization. description: >- Request has not been applied because it lacks valid authentication credentials. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: PREFIX:ID:SECRET description: >- Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are required to make a successful request. ````