Email OTP Signer

You are viewing docs for the previous version of the Wallets SDK. We recommend upgrading to V1. See the updated version of this page or the V1 migration guide.

Use an email OTP signer to let users authenticate via a one-time password sent to their email address. Email signers can be configured as a recovery signer (to regain wallet access on a new device) or as an operational signer (to authorize day-to-day transactions). A wallet can have multiple email signers. For a conceptual overview, see Email OTP in the Wallet Signers guide. To learn how to register operational signers on a wallet, see Registering a signer.

Configuration

React
Node.js
React Native
REST

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { getOrCreateWallet } = useWallet();

const wallet = await getOrCreateWallet({
    chain: "base",
    signer: {
        type: "email",
        email: "user@example.com"
    },
});

import { CrossmintWallets, createCrossmint } from "@crossmint/wallets-sdk";

const crossmint = createCrossmint({
    apiKey: "<your-server-api-key>",
});
const crossmintWallets = CrossmintWallets.from(crossmint);

const wallet = await crossmintWallets.createWallet({
    chain: "base",
    signer: {
        type: "email",
        email: "user@example.com"
    },
});

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { getOrCreateWallet } = useWallet();

const wallet = await getOrCreateWallet({
    chain: "base",
    signer: {
        type: "email",
        email: "user@example.com"
    },
});

curl --request POST \
    --url https://staging.crossmint.com/api/2025-06-09/wallets \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: <x-api-key>' \
    --data '{
        "chainType": "evm",
        "config": {
            "adminSigner": {
                "type": "email",
                "email": "user@example.com"
            }
        }
    }'

const url = 'https://staging.crossmint.com/api/2025-06-09/wallets';

const payload = {
    chainType: "evm",
    config: {
        adminSigner: {
            type: "email",
            email: "user@example.com"
        }
    }
};

const options = {
    method: 'POST',
    headers: {
        'X-API-KEY': '<x-api-key>',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(payload)
};

try {
    const response = await fetch(url, options);
    const data = await response.json();
    console.log(data);
} catch (error) {
    console.error(error);
}

import requests

url = "https://staging.crossmint.com/api/2025-06-09/wallets"

payload = {
    "chainType": "evm",
    "config": {
        "adminSigner": {
            "type": "email",
            "email": "user@example.com"
        }
    }
}
headers = {
    "X-API-KEY": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

Configuration

​Configuration

Configuration