Create Signature

Changed on Sep 21, 2026

Creates a new signature for signing messages or typed data.

API scope required: wallets:signatures.create

post/2025-06-09/wallets/{walletLocator}/signatures

Request

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

Path parameters

walletLocatorstring required

A wallet locator can be of the format:

<walletAddress>
email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
chainType[:<walletType>]:alias:<alias>

Headers

X-API-KEYstring required

API key required for authentication

x-idempotency-keystring

Unique key to prevent duplicate signature creation

Request body

Example request

{
  "params": {
    "signer": "external-wallet:0x1234567890123456789012345678901234567890"
  }
}

Response

The signature has been successfully created.

idstring required

Unique identifier for the signature

type'message' | 'typed-data' | 'auth-entries' required

The type of signature

chainType'evm' | 'solana' | 'aptos' | 'sui' | 'stellar' required

The blockchain type of the wallet

walletType'smart' | 'mpc' required

The wallet type (smart or mpc)

status'awaiting-approval' | 'pending' | 'failed' | 'success' required

Current status of the signature

errorunknown

outputSignaturestring

The wallet's output signature of the request

Changes

Sep 21, 20263983c72e453a Revision changes
- breaking
  removed the enum value astar-zkevm of the request property //
- breaking
  removed the enum value astar-zkevm of the request property //
- breaking
  removed the enum value base-goerli of the request property //
- breaking
  removed the enum value base-goerli of the request property //
- breaking
  removed the enum value coti of the request property //
- breaking
  removed the enum value coti of the request property //
- breaking
  removed the enum value coti-testnet of the request property //
- breaking
  removed the enum value coti-testnet of the request property //
- breaking
  removed the enum value ethereum-goerli of the request property //
- breaking
  removed the enum value ethereum-goerli of the request property //
- breaking
  removed the enum value hedera of the request property //
- breaking
  removed the enum value hedera of the request property //
- breaking
  removed the enum value hedera-testnet of the request property //
- breaking
  removed the enum value hedera-testnet of the request property //
- breaking
  removed the enum value lightlink of the request property //
- breaking
  removed the enum value lightlink of the request property //
- breaking
  removed the enum value lightlink-pegasus of the request property //
- breaking
  removed the enum value lightlink-pegasus of the request property //
- breaking
  removed the enum value mode of the request property //
- 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 mode-sepolia of the request property //
- breaking
  removed the enum value optimism-goerli of the request property //
- breaking
  removed the enum value optimism-goerli of the request property //
- breaking
  removed the enum value plume 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 plume-testnet of the request property //
- breaking
  removed the enum value polygon-mumbai of the request property //
- breaking
  removed the enum value polygon-mumbai of the request property //
- breaking
  removed the enum value rari of the request property //
- breaking
  removed the enum value rari of the request property //
- breaking
  removed the enum value rari-testnet of the request property //
- breaking
  removed the enum value rari-testnet of the request property //
- breaking
  removed the enum value soneium of the request property //
- breaking
  removed the enum value soneium of the request property //
- breaking
  removed the enum value soneium-minato-testnet of the request property //
- breaking
  removed the enum value soneium-minato-testnet of the request property //
- breaking
  removed the enum value u2u-nebulas of the request property //
- breaking
  removed the enum value u2u-nebulas of the request property //
- breaking
  removed the enum value u2u-solaris of the request property //
- breaking
  removed the enum value u2u-solaris of the request property //
- breaking
  removed the enum value viction of the request property //
- breaking
  removed the enum value viction of the request property //
- breaking
  removed the enum value viction-testnet of the request property //
- breaking
  removed the enum value viction-testnet of the request property //
- breaking
  removed the enum value world-chain 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
  removed the enum value world-chain-sepolia of the request property //
- breaking
  removed the enum value xai of the request property //
- breaking
  removed the enum value xai of the request property //
- breaking
  removed the enum value xai-sepolia-testnet of the request property //
- breaking
  removed the enum value xai-sepolia-testnet of the request property //
- breaking
  removed the enum value zenchain-testnet of the request property //
- breaking
  removed the enum value zenchain-testnet of the request property //
- breaking
  removed the enum value zkatana of the request property //
- breaking
  removed the enum value zkatana of the request property //
- breaking
  removed the enum value zkyoto of the request property //
- breaking
  removed the enum value zkyoto of the request property //
- breaking
  removed the enum value zora-goerli of the request property //
- breaking
  removed the enum value zora-goerli of the request property //
- info
  removed the astar-zkevm enum value from the // response property for the response status
- info
  removed the astar-zkevm enum value from the // response property for the response status
- info
  removed the base-goerli enum value from the // response property for the response status
- info
  removed the base-goerli enum value from the // response property for the response status
- info
  removed the coti enum value from the // response property for the response status
- info
  removed the coti enum value from the // response property for the response status
- info
  removed the coti-testnet enum value from the // response property for the response status
- info
  removed the coti-testnet enum value from the // response property for the response status
- info
  removed the ethereum-goerli enum value from the // response property for the response status
- info
  removed the ethereum-goerli enum value from the // response property for the response status
- info
  removed the hedera enum value from the // response property for the response status
- info
  removed the hedera enum value from the // response property for the response status
- info
  removed the hedera-testnet enum value from the // response property for the response status
- info
  removed the hedera-testnet enum value from the // response property for the response status
- info
  removed the lightlink enum value from the // response property for the response status
- info
  removed the lightlink enum value from the // response property for the response status
- info
  removed the lightlink-pegasus enum value from the // response property for the response status
- info
  removed the lightlink-pegasus enum value from the // response property for the response status
- info
  removed the mode enum value from the // response property for the response status
- info
  removed the mode enum value from the // response property for the response status
- info
  removed the mode-sepolia enum value from the // response property for the response status
- info
  removed the mode-sepolia enum value from the // response property for the response status
- info
  removed the optimism-goerli enum value from the // response property for the response status
- info
  removed the optimism-goerli enum value from the // response property for the response status
- info
  removed the plume enum value from the // response property for the response status
- info
  removed the plume enum value from the // response property for the response status
- info
  removed the plume-testnet enum value from the // response property for the response status
- info
  removed the plume-testnet enum value from the // response property for the response status
- info
  removed the polygon-mumbai enum value from the // response property for the response status
- info
  removed the polygon-mumbai enum value from the // response property for the response status
- info
  removed the rari enum value from the // response property for the response status
- info
  removed the rari enum value from the // response property for the response status
- info
  removed the rari-testnet enum value from the // response property for the response status
- info
  removed the rari-testnet enum value from the // response property for the response status
- info
  removed the soneium enum value from the // response property for the response status
- info
  removed the soneium enum value from the // response property for the response status
- info
  removed the soneium-minato-testnet enum value from the // response property for the response status
- info
  removed the soneium-minato-testnet enum value from the // response property for the response status
- info
  removed the u2u-nebulas enum value from the // response property for the response status
- info
  removed the u2u-nebulas enum value from the // response property for the response status
- info
  removed the u2u-solaris enum value from the // response property for the response status
- info
  removed the u2u-solaris enum value from the // response property for the response status
- info
  removed the viction enum value from the // response property for the response status
- info
  removed the viction enum value from the // response property for the response status
- info
  removed the viction-testnet enum value from the // response property for the response status
- info
  removed the viction-testnet enum value from the // response property for the response status
- info
  removed the world-chain enum value from the // response property for the response status
- info
  removed the world-chain enum value from the // response property for the response status
- info
  removed the world-chain-sepolia enum value from the // response property for the response status
- info
  removed the world-chain-sepolia enum value from the // response property for the response status
- info
  removed the xai enum value from the // response property for the response status
- info
  removed the xai enum value from the // response property for the response status
- info
  removed the xai-sepolia-testnet enum value from the // response property for the response status
- info
  removed the xai-sepolia-testnet enum value from the // response property for the response status
- info
  removed the zenchain-testnet enum value from the // response property for the response status
- info
  removed the zenchain-testnet enum value from the // response property for the response status
- info
  removed the zkatana enum value from the // response property for the response status
- info
  removed the zkatana enum value from the // response property for the response status
- info
  removed the zkyoto enum value from the // response property for the response status
- info
  removed the zkyoto enum value from the // response property for the response status
- info
  removed the zora-goerli enum value from the // response property for the response status
- info
  removed the zora-goerli enum value from the // response property for the response status
Sep 16, 202619493bf640a4 Revision changes
- warning
  added the new arc enum value to the // response property for the response status
- warning
  added the new arc enum value to the // response property for the response status
- warning
  added the new celo enum value to the // response property for the response status
- warning
  added the new celo enum value to the // response property for the response status
- warning
  added the new celo-sepolia enum value to the // response property for the response status
- warning
  added the new celo-sepolia enum value to the // response property for the response status
- info
  added the new arc enum value to the request property //
- info
  added the new arc enum value to the request property //
- info
  added the new celo enum value to the request property //
- info
  added the new celo enum value to the request property //
- info
  added the new celo-sepolia enum value to the request property //
- info
  added the new celo-sepolia enum value to the request property //

Operation history (15 revisions)