Quickstart ⚡

Mint and send a unique NFT in under 5 minutes

In this quickstart you will learn how to create a unique NFT and deliver it to a wallet or email address.

Integration steps

EVM Chains

1. Create a Developer Account

To get started, create a developer account in the Crossmint Staging Console. Open that link, sign in, and accept the dialog to continue.

Crossmint offers two consoles: staging, for development and testing, and production.

2. Get an API Key

Once you log in to the console, the next step is to create an API key.

Click the "Integrate" tab and click on the "API Keys" option on top.

Within the “Server-side keys” section, click the “Create new key” button in the top right. Then, check the scopes nfts.create and nfts.read under the “Minting API” category and create your key. Save this key for the next step.

3. Mint an NFT

We’re almost there! With our key created, we’re now going to write a small function that creates an NFT and delivers it to a user.

Create a file (e.g. mintNFT.js) and enter this code into it:

mintNFT.js

const apiKey = "YOUR_API_KEY";
const chain = "polygon-amoy"; // or "ethereum-sepolia", "base-sepolia", etc.
const env = "staging"; // or "www"
const recipientEmail = "TEST_EMAIL_ADDRESS";
const recipientAddress = `email:${recipientEmail}:${chain}`;

const url = `https://${env}.crossmint.com/api/2022-06-09/collections/default/nfts`;
const options = {
    method: "POST",
    headers: {
        accept: "application/json",
        "content-type": "application/json",
        "x-api-key": apiKey,
    },
    body: JSON.stringify({
        recipient: recipientAddress,
        metadata: {
            name: "Crossmint Test NFT",
            image: "https://picsum.photos/400",
            description: "My first NFT using Crossmint",
        },
    }),
};

fetch(url, options)
    .then((res) => res.json())
    .then((json) => console.log(json))
    .catch((err) => console.error("error:" + err));

This code creates an NFT, uploads it to the blockchain, and delivers it to a user wallet, attached to the email address provided. Before running it, be sure to fill in values for:

• YOUR_API_KEY with the key obtained in the prior step.
• TEST_EMAIL_ADDRESS with an email address you control, for testing.

Now, run the mintNFT.js script.

node mintNFT.js

After a few seconds, it should return a response indicating the mint has started processing. Check the full response and save its actionId property, as you’ll use it later.

Example response

Here is an example response returned from the API call above:

JSON

{
    "id": "b3f61f22-c30e-424d-a5ab-d0cbc5c41aab",
    "onChain": {
        "status": "pending",
        "chain": "polygon-amoy",
        "contractAddress": "0x921Bc21bf3Fd6568cdC2C904F75b83556062c3d0"
    },
    "actionId": "b3f61f22-c30e-424d-a5ab-d0cbc5c41aab"
}

4. Confirm Delivery of the NFT

The mint has started processing. However, blockchains can take a few seconds (or, at times of extreme network congestion, even minutes) to confirm the operation.

Before showing the user a success screen, the next step is checking the status of the mint.

To do this, grab the actionId received at the end of step 3 and use it alongside your API key in one of the snippets below.

mintStatus.js

const apiKey = "<YOUR_API_KEY>";
const env = "staging"; // or "www"
const actionId = "<MINT_ACTION_ID>";

const url = `https://${env}.crossmint.com/api/2022-06-09/actions/${actionId}`;
const options = {
    method: "GET",
    headers: { "X-API-KEY": apiKey },
};

fetch(url, options)
    .then((response) => response.json())
    .then((response) => console.log(response))
    .catch((err) => console.error(err));

Example response

Here is an example response from calling the status API:

JSON

{
  "actionId": "b3f61f22-c30e-424d-a5ab-d0cbc5c41aab",
  "action": "nfts.create",
  "status": "success",
  "data": {
    "collection": {...},
    "recipient": {...},
    "token": {...}
  },
  "startedAt": "2025-05-27T02:41:08.000Z",
  "completedAt": "2025-05-27T02:41:40.000Z",
  "resource": "https://staging.crossmint.com/api/2022-06-09/collections/default-polygon-amoy/nfts/b3f61f22-c30e-424d-a5ab-d0cbc5c41aab"
}

Pay attention to the “status” field. Once it says “success”:

Congratulations. You have minted your first NFT 🥷 🎉

For scalable production applications, consider using webhooks to determine when your NFT has been minted, instead of periodically polling for its status via the API.

View your NFTs

1. If the NFTs were delivered to an email address, the recipient can see them by:

   • Logging into their wallet from Crossmint’s website. For staging, they must use https://staging.crossmint.com.
   • From your website if you use embedded wallets. See the API for getting the NFTs in a wallet.

2. If the NFTs were delivered to a wallet address, the user will be able to see them there directly, connecting to testnet if needed, or on the testnet blockchain explorer.

And voilá, there’s your NFT! Now think of all the cool things you can build with this, at scale :)

Launching in Production

For production, the steps are almost identical, but some changes are required:

1. Create a developer account on the production console.
2. Add credits to your account from Billing & Usage.
3. Then, create a production key on the API Keys page with the same API scopes.
4. Modify all code snippets with const env = "www", so they use the production APIs. You may also need to change the chain variable to match your production blockchain.
5. Check the guide with best practices

Learn More

Create collections

Learn how to create and manage NFT collections.

Mint NFTs and other tokens

Check out more advanced options for minting digital assets.

Edit NFTs

Update and delete tokens after minting.