Sign in

Create Wallet For Authenticated User

Changed on

Creates a new wallet of specified type for the authenticated user. If called for a user who already has a wallet, returns the existing wallet. Supports both custodial and non-custodial wallet types. Uses client-side API key authentication.

API scope required: wallets.create

post/2025-06-09/wallets/me

Request

  • Base URL: https://staging.crossmint.com/api
  • URL: https://staging.crossmint.com/api/2025-06-09/wallets/me
  • Auth: none declared. Required headers: X-API-KEY

Headers

X-API-KEYstring required

API key required for authentication

Request body

OR
OR
OR
OR
OR
OR

Example request

{
  "config": {
    "adminSigner": {
      "type": "external-wallet",
      "address": "0x1234567890123456789012345678901234567890"
    },
    "recoveryMethods": {
      "type": "external-wallet",
      "address": "0x1234567890123456789012345678901234567890"
    },
    "delegatedSigners": [
      {
        "signer": {
          "type": "passkey",
          "id": "cWtP7gmZbd98HbKUuGXx5Q",
          "name": "hgranger",
          "publicKey": {
            "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
            "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
          }
        },
        "scopes": [
          {
            "type": "transfer",
            "tokenLocator": "stellar:usdc",
            "recipients": [
              "GDUCX62IF76FFIYRNI25LJDS2V43QEZDY4YNF2DJWVIASN5LKX76Q4TW"
            ],
            "spendingLimit": {
              "amount": "100",
              "interval": 86400
            }
          }
        ]
      }
    ],
    "creationSeed": "0"
  },
  "alias": "my-usdc-wallet"
}

Response

Returns an existing wallet (200) if one already exists for this user, or creates and returns a new wallet (201).

OR
OR
OR
OR

Example response

{
  "type": "smart",
  "config": {
    "adminSigner": {
      "type": "passkey",
      "id": "cWtP7gmZbd98HbKUuGXx5Q",
      "name": "hgranger",
      "publicKey": {
        "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
        "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
      },
      "validatorContractVersion": "0.2.0",
      "locator": "passkey:cWtP7gmZbd98HbKUuGXx5Q"
    }
  },
  "address": "0x1234567890123456789012345678901234567890",
  "owner": "email:test@example.com",
  "alias": "my-usdc-wallet"
}

Changes

  • c9d4b4eb588aRevision changes
    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the request property //

    • warning

      removed the request property //

    • warning

      removed the request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

  • 8a293eb59891Revision changes
    • breaking

      the // request property's minItems was increased to 1

    • breaking

      the // request property's minItems was increased to 1

    • breaking

      removed subschema #1: External Wallet Signer subschema #2: Server Signer subschema #3: API Key Signer subschema #4: Email Signer subschema #5: Phone Signer subschema #6: Quorum Signer from the // request property oneOf list

    • breaking

      removed subschema #1: External Wallet Signer subschema #2: Server Signer subschema #3: Email Signer subschema #4: Phone Signer subschema #5: API Key Signer subschema #6: Quorum Signer from the // request property oneOf list

    • breaking

      the // request property type changed from no type to array

    • breaking

      the // request property type changed from no type to array

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status