Create Delegated Signer

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/signers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "signer": "external-wallet:0x1234567890123456789012345678901234567890",
  "chain": "base"
}
'

{
  "type": "external-wallet",
  "id": "cWtP7gmZbd98HbKUuGXx5Q",
  "name": "hgranger",
  "publicKey": {
    "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
    "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
  },
  "validatorContractVersion": "0.2.0",
  "locator": "external-wallet:DzaYNi6XtWt9DNwFV61bzWEiaSxfTgWbFDgFmurJzwdo",
  "address": "DzaYNi6XtWt9DNwFV61bzWEiaSxfTgWbFDgFmurJzwdo",
  "transaction": {
    "chainType": "solana",
    "walletType": "smart",
    "onChain": {
      "transaction": "4B9yzZoEV45cngasy9dP2MVxhZ2iro72eqdKitTj62pqFYHk4wVoR4NCc3xkEamWbFGXLjVotyPrDqEn11WUYHoq98b5aKCSDUrLWaQDZgb3xLxF1EvaY82Vui7Ntbv682tYnu5Ngnv4Eun1wrDJ6r4aRsUSQ3XF3jvNq8bRMn4HavBjPyErQSgXX9ytCDKntCEQcY3wfMHYbRFg5zgFU1QCqhuoLa5oBpZLCUYT8DCYu3Ado7W4xzP5aCAAwVd2tj8iAnwJEujQvBnr7wWkf2mCS1cNoCTbCFAvNVaVaau6vXBWKZqS7sDNmUD3KLQVqLwxhLLNeRuvUTkD5VQ5D21VcDiYWQWQTuYYAcQ3RUhn4Vt4ymijgRGbUXZHoeN26UHoGSBFJJ7gjqCruAtFXQZxHRDKSWN9jhYXugPYVVXSpGFA5BYWBuztUtEMF4u96tk6YTgPGdkTgrQybkNxRwbVCbpsKRG1kAbjQgBxDLAX89eMCZVbzWXnAgGA6aDBQPLAyQru8awZBDasrirnxCSQq9cWwMLePQGhY5gJZykswFKtyYF4CHeto",
      "lastValidBlockHeight": 343486121
    },
    "id": "30ef7527-eb5a-4862-92de-aa96947ee705",
    "status": "pending",
    "approvals": {
      "required": 1,
      "pending": [
        {
          "signer": {
            "type": "external-wallet",
            "address": "GsMTPi8utYnuWakS8uvPah3UKd13dWcAshirnNmXDr3d",
            "locator": "external-wallet:GsMTPi8utYnuWakS8uvPah3UKd13dWcAshirnNmXDr3d"
          },
          "message": "2kwN1iuY6Y6Br2i5D1QphaS28H7vDdAiwtABgtRdYqjx7s85rRwqF9y6iVBdv9dDZ8F1JAZo8iQdFBAx2Eg9tL3P4sbAznPZgkZcGrbUSCe5jTZ7ULZrcSd377SGEjsZcwx7h7ozrUKB6FnjHB7wGaCqEeeUXE2CfCjC1SjEc8ZzZeyNmeEv5hJSkGsK62syoAE4V5ScZs7idhxXWzpeJiRt3wfWJRevr1pJY7BBd8HaEYurXtXqwCox1uzQnnuZTiUNu7cUWUajYXBWUae4NJGJxmtFJvqnPAa5HXB4nZWXMDdcBis4tQkLCfFT6GXMauQTFCaKmcMgLRh218n51nTNopR7gTaY66ysRH536wmxt9dLqkS9okG3HF5GEXufXPLX6iT7e7"
        }
      ],
      "submitted": []
    },
    "createdAt": "2025-01-20T13:49:08.910Z"
  }
}

POST

2025-06-09

wallets

{walletLocator}

signers

Create Delegated Signer

curl --request POST \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/signers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "signer": "external-wallet:0x1234567890123456789012345678901234567890",
  "chain": "base"
}
'

{
  "type": "external-wallet",
  "id": "cWtP7gmZbd98HbKUuGXx5Q",
  "name": "hgranger",
  "publicKey": {
    "x": "38035223810536273945556366218149112558607829411547667975304293530457502824247",
    "y": "91117823763706733837104303008228095481082989039135234750508288790583476078729"
  },
  "validatorContractVersion": "0.2.0",
  "locator": "external-wallet:DzaYNi6XtWt9DNwFV61bzWEiaSxfTgWbFDgFmurJzwdo",
  "address": "DzaYNi6XtWt9DNwFV61bzWEiaSxfTgWbFDgFmurJzwdo",
  "transaction": {
    "chainType": "solana",
    "walletType": "smart",
    "onChain": {
      "transaction": "4B9yzZoEV45cngasy9dP2MVxhZ2iro72eqdKitTj62pqFYHk4wVoR4NCc3xkEamWbFGXLjVotyPrDqEn11WUYHoq98b5aKCSDUrLWaQDZgb3xLxF1EvaY82Vui7Ntbv682tYnu5Ngnv4Eun1wrDJ6r4aRsUSQ3XF3jvNq8bRMn4HavBjPyErQSgXX9ytCDKntCEQcY3wfMHYbRFg5zgFU1QCqhuoLa5oBpZLCUYT8DCYu3Ado7W4xzP5aCAAwVd2tj8iAnwJEujQvBnr7wWkf2mCS1cNoCTbCFAvNVaVaau6vXBWKZqS7sDNmUD3KLQVqLwxhLLNeRuvUTkD5VQ5D21VcDiYWQWQTuYYAcQ3RUhn4Vt4ymijgRGbUXZHoeN26UHoGSBFJJ7gjqCruAtFXQZxHRDKSWN9jhYXugPYVVXSpGFA5BYWBuztUtEMF4u96tk6YTgPGdkTgrQybkNxRwbVCbpsKRG1kAbjQgBxDLAX89eMCZVbzWXnAgGA6aDBQPLAyQru8awZBDasrirnxCSQq9cWwMLePQGhY5gJZykswFKtyYF4CHeto",
      "lastValidBlockHeight": 343486121
    },
    "id": "30ef7527-eb5a-4862-92de-aa96947ee705",
    "status": "pending",
    "approvals": {
      "required": 1,
      "pending": [
        {
          "signer": {
            "type": "external-wallet",
            "address": "GsMTPi8utYnuWakS8uvPah3UKd13dWcAshirnNmXDr3d",
            "locator": "external-wallet:GsMTPi8utYnuWakS8uvPah3UKd13dWcAshirnNmXDr3d"
          },
          "message": "2kwN1iuY6Y6Br2i5D1QphaS28H7vDdAiwtABgtRdYqjx7s85rRwqF9y6iVBdv9dDZ8F1JAZo8iQdFBAx2Eg9tL3P4sbAznPZgkZcGrbUSCe5jTZ7ULZrcSd377SGEjsZcwx7h7ozrUKB6FnjHB7wGaCqEeeUXE2CfCjC1SjEc8ZzZeyNmeEv5hJSkGsK62syoAE4V5ScZs7idhxXWzpeJiRt3wfWJRevr1pJY7BBd8HaEYurXtXqwCox1uzQnnuZTiUNu7cUWUajYXBWUae4NJGJxmtFJvqnPAa5HXB4nZWXMDdcBis4tQkLCfFT6GXMauQTFCaKmcMgLRh218n51nTNopR7gTaY66ysRH536wmxt9dLqkS9okG3HF5GEXufXPLX6iT7e7"
        }
      ],
      "submitted": []
    },
    "createdAt": "2025-01-20T13:49:08.910Z"
  }
}

Headers

X-API-KEY

string

required

API key required for authentication

Path Parameters

walletLocator

string

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>

Body

application/json

EVM
Solana
Stellar

Parameters for creating a EVM delegated signer

signer

required

Configuration for a WebAuthn/Passkey signer that uses public key credentials for authentication

Show child attributes

signer.type

enum<string>

required

Identifier for the Passkey signer type

Available options:

passkey

signer.id

string

required

Credential ID from the WebAuthn registration response

signer.name

string

required

Human-readable name for the passkey

signer.publicKey

object

required

The public key coordinates from the WebAuthn credential

Show child attributes

signer.publicKey.x

string

required

X coordinate of the public key as a decimal string

signer.publicKey.y

string

required

Y coordinate of the public key as a decimal string

Example:

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

chain

enum<string>

required

The chain where the signer will be registered

Available options:

abstract,

apechain,

arbitrum,

arbitrumnova,

avalanche,

base,

bsc,

flow,

mantle,

mode,

optimism,

plume,

polygon,

scroll,

sei-pacific-1,

shape,

story,

world-chain,

zora,

abstract-testnet,

arbitrum-sepolia,

avalanche-fuji,

base-sepolia,

curtis,

ethereum-sepolia,

flow-testnet,

mantle-sepolia,

mode-sepolia,

optimism-sepolia,

plume-testnet,

polygon-amoy,

scroll-sepolia,

sei-atlantic-2-testnet,

story-testnet,

world-chain-sepolia,

zora-sepolia,

arc-testnet

expiresAt

number

The expiry date of the signer in ISO 8601 format

Example:

"2024-01-01T00:00:00.000Z"

Response

The delegated signer has been successfully created.

Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response
Delegated Signer Response

Complete delegated signer response including the signer and authorization transaction

type

enum<string>

required

Identifier for the Passkey signer type

Available options:

passkey

string

required

Credential ID from the WebAuthn registration response

name

string

required

Human-readable name for the passkey

publicKey

object

required

The public key coordinates from the WebAuthn credential

Show child attributes

publicKey.x

string

required

X coordinate of the public key as a decimal string

publicKey.y

string

required

Y coordinate of the public key as a decimal string

validatorContractVersion

string

required

ERC-7579 webAuthn validator contract version

locator

string

required

Unique identifier for locating this passkey signer

transaction

object

The transaction for the signer

Show child attributes

transaction.chainType

enum<string>

required

Available options:

solana

transaction.onChain

object

required

Show child attributes

transaction.onChain.transaction

string

required

transaction.onChain.lastValidBlockHeight

number

transaction.onChain.txId

string

transaction.onChain.explorerLink

string

transaction.id

string

required

Unique identifier for the transaction

transaction.status

enum<string>

required

Current status of the transaction

Available options:

awaiting-approval,

pending,

failed,

success

transaction.createdAt

required

ISO timestamp when the transaction was created

Example:

"2024-01-01T00:00:00.000Z"

transaction.walletType

enum<string>

required

Available options:

smart

transaction.approvals

object

Complete approval data including requirements, pending and submitted signatures

Show child attributes

transaction.approvals.pending

object[]

required

List of pending signatures

Show child attributes

transaction.approvals.pending.signer

External Wallet Signer · object

required

The full signer object that's pending approval

External Wallet Signer
Passkey Signer
API Key Signer
Device Signer
Option 5
Option 6

Show child attributes

transaction.approvals.pending.signer.type

enum<string>

required

Available options:

external-wallet

transaction.approvals.pending.signer.address

string

required

The address of the external wallet

transaction.approvals.pending.signer.locator

string

required

The locator of the external wallet signer

transaction.approvals.pending.message

string

required

The message that needs to be signed

transaction.approvals.submitted

object[]

required

Record of all submitted signatures

Show child attributes

transaction.approvals.submitted.signature

string

required

The cryptographic signature

transaction.approvals.submitted.submittedAt

required

When the signature was submitted

Example:

"2024-01-01T00:00:00.000Z"

transaction.approvals.submitted.signer

External Wallet Signer · object

required

The full signer object who submitted this signature

External Wallet Signer
Passkey Signer
API Key Signer
Device Signer
Option 5
Option 6

Show child attributes

transaction.approvals.submitted.signer.type

enum<string>

required

Available options:

external-wallet

transaction.approvals.submitted.signer.address

string

required

The address of the external wallet

transaction.approvals.submitted.signer.locator

string

required

The locator of the external wallet signer

transaction.approvals.submitted.message

string

required

The message that was signed

transaction.approvals.submitted.metadata

object

Additional metadata about the signature submission

Show child attributes

transaction.approvals.submitted.metadata.deviceInfo

string

transaction.approvals.submitted.metadata.ipAddress

string

transaction.approvals.submitted.metadata.userAgent

string

transaction.approvals.required

number

Number of required approvals for the transaction

transaction.completedAt

ISO timestamp when the transaction reached finality

Example:

"2024-01-01T00:00:00.000Z"

transaction.error

object

Error message if the transaction fails after submission

Option 1
Option 2
Option 3

Show child attributes

transaction.error.reason

enum<string>

required

Available options:

build_failed,

failed_to_land_on_chain,

unknown,

sanctioned_wallet_address

transaction.error.message

string

required

transaction.sendParams

object

Show child attributes

transaction.sendParams.token

string

required

The token locator that's being sent

transaction.sendParams.params

object

required

The parameters for the send token transaction

Show child attributes

transaction.sendParams.params.recipient

string

required

The recipient locator for the token

transaction.sendParams.params.recipientAddress

string

required

The recipient address for the token

transaction.sendParams.params.amount

string

The amount of the token to send

Approve Signature Get Delegated Signer

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

Create Delegated Signer

Headers

Path Parameters

Body

Response