---
title: "Mint NFT(s)"
method: POST
path: "/v2/farcaster/nft/mint/"
tags: ["Onchain"]
---

# Mint NFT(s)

`POST /v2/farcaster/nft/mint/`

Mints an NFT to one or more recipients on a specified network and contract, using a configured server wallet. Contact us to set up your wallet configuration if you don't have one.

## Headers

- `x-wallet-id` string, required

## Request body

- object — Request body for NFT minting operation.
  - `async` boolean — If true, returns immediately after sending the transaction.
  - `contract_address` string, required — Ethereum address
  - `network` 'base' | 'optimism' | 'base-sepolia', required — Network to mint on.
  - `recipients` union[], required — List of recipients to mint to (1-200 recipients allowed).
    - union — NFT mint recipient. Exactly one of "address" or "fid" must be set.
      - object
        - `address` string, required — Ethereum address
        - `quantity` integer — Quantity to mint (must be at least 1). Defaults to 1.
      - object
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `quantity` integer — Quantity to mint (must be at least 1). Defaults to 1.

## Response `200`

Success

- object — Response for NFT minting operation.
  - `transactions` union[], required — Array of per-recipient mint results (success or error).
    - union
      - object — Successful mint transaction.
        - `receipt` object, nullable — Transaction receipt (if async is false).
          - `block_number` string, required
          - `gas_used` string, required
          - `status` string, required
        - `recipient` object, required — Resolved mint recipient.
          - `address` string, required — Ethereum address
          - `fid` integer — The unique identifier of a farcaster user or app (unsigned integer)
          - `quantity` integer, required
          - `tokens` object[] — Minted token IDs parsed from Transfer events (sync mode only).
            - `token_id` string, required
        - `transaction_hash` string, required — Hexadecimal number expressed as string with '0x' prefix
      - object — Failed mint for a single recipient.
        - `error` string, required — Error message for this recipient.
        - `recipient` object, required — Mint recipient that failed.
          - `address` string — Ethereum address
          - `fid` integer — The unique identifier of a farcaster user or app (unsigned integer)
          - `quantity` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — Resource not found
- `500` — Server Error

---

[API](https://skmtc.net/neynar/apis/neynar-api.md) · [All operations](https://skmtc.net/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neynar/neynar-api/versions/dbb91bfb0d1a/schema)