Create Delegated Signer For Authenticated User

Changed on

Register a delegated key for a smart wallet with optional restrictions around permissions and expiry date.

API scope required: wallets.create

post/2025-06-09/wallets/me{walletLocator}/signers

Request

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

Path parameters

walletLocatorstring required

Headers

X-API-KEYstring required

API key required for authentication

Request body

OR
OR

Example request

{
  "signer": {
    "type": "passkey",
    "id": "cWtP7gmZbd98HbKUuGXx5Q",
    "name": "hgranger",
    "publicKey": {
      "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
      "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
    }
  },
  "approver": "passkey:cWtP7gmZbd98HbKUuGXx5Q",
  "scopes": [
    {
      "type": "transfer",
      "tokenLocator": "stellar:usdc",
      "recipients": [
        "GDUCX62IF76FFIYRNI25LJDS2V43QEZDY4YNF2DJWVIASN5LKX76Q4TW"
      ],
      "spendingLimit": {
        "amount": "100",
        "interval": 86400
      }
    }
  ]
}

Response

The delegated signer has been successfully added to the wallet.

OR
OR

Example response

{
  "type": "passkey",
  "id": "cWtP7gmZbd98HbKUuGXx5Q",
  "name": "hgranger",
  "publicKey": {
    "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
    "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
  },
  "validatorContractVersion": "0.2.0",
  "locator": "passkey:cWtP7gmZbd98HbKUuGXx5Q"
}

Changes

    • breaking

      removed the enum value mode of the request property /

    • breaking

      removed the enum value mode-sepolia of the request property /

    • breaking

      removed the enum value plume of the request property /

    • breaking

      removed the enum value plume-testnet of the request property /

    • breaking

      removed the enum value world-chain of the request property /

    • breaking

      removed the enum value world-chain-sepolia of the request property /

    • breaking

      request property / was restricted to a list of enum values

    • breaking

      the //// request property's minLength was increased from 0 to 1

    • breaking

      the //// request property's minLength was increased from 0 to 1

    • breaking

      the //// request property's minLength was increased from 0 to 1

    • breaking

      added the pattern ^[A-Za-z0-9_-]+$ to the request property ////

    • breaking

      added the pattern ^[A-Za-z0-9_-]+$ to the request property ////

    • breaking

      added the pattern ^[A-Za-z0-9_-]+$ to 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 new abstract enum value to the request property /

    • info

      added the new abstract-testnet enum value to the request property /

    • info

      added the new apechain enum value to the request property /

    • info

      added the new arbitrum enum value to the request property /

    • info

      added the new arbitrum-sepolia enum value to the request property /

    • info

      added the new arbitrumnova enum value to the request property /

    • info

      added the new arc-testnet enum value to the request property /

    • info

      added the new avalanche enum value to the request property /

    • info

      added the new avalanche-fuji enum value to the request property /

    • info

      added the new base enum value to the request property /

    • info

      added the new base-sepolia enum value to the request property /

    • info

      added the new bsc enum value to the request property /

    • info

      added the new curtis enum value to the request property /

    • info

      added the new ethereum enum value to the request property /

    • info

      added the new ethereum-sepolia enum value to the request property /

    • info

      added the new flow enum value to the request property /

    • info

      added the new flow-testnet enum value to the request property /

    • info

      added the new mantle enum value to the request property /

    • info

      added the new mantle-sepolia enum value to the request property /

    • info

      added the new mode enum value to the request property /

    • info

      added the new mode-sepolia enum value to the request property /

    • info

      added the new optimism enum value to the request property /

    • info

      added the new optimism-sepolia enum value to the request property /

    • info

      added the new plume enum value to the request property /

    • info

      added the new plume-testnet enum value to the request property /

    • info

      added the new polygon enum value to the request property /

    • info

      added the new polygon-amoy enum value to the request property /

    • info

      added the new scroll enum value to the request property /

    • info

      added the new scroll-sepolia enum value to the request property /

    • info

      added the new sei-atlantic-2-testnet enum value to the request property /

    • info

      added the new sei-pacific-1 enum value to the request property /

    • info

      added the new shape enum value to the request property /

    • info

      added the new story enum value to the request property /

    • info

      added the new story-testnet enum value to the request property /

    • info

      added the new tempo enum value to the request property /

    • info

      added the new tempo-testnet enum value to the request property /

    • info

      added the new world-chain enum value to the request property /

    • info

      added the new world-chain-sepolia enum value to the request property /

    • info

      added the new zora enum value to the request property /

    • info

      added the new zora-sepolia enum value to the request property /