> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mint SFT

> Mint your SFTs and deliver them to a web3 wallet or an email address

**API scope required**: `nfts.create`




## OpenAPI

````yaml post /2022-06-09/collections/{collectionId}/sfts
openapi: 3.0.1
info:
  description: N/A
  version: 1.0.0
  title: NFT Minting
  contact:
    name: Crossmint NFT Minting APIs
    url: https://www.crossmint.com
    email: support@crossmint.com
servers:
  - url: https://staging.crossmint.com/api
    description: Staging environment (testnets)
  - url: https://www.crossmint.com/api
    description: Production environment (mainnets)
security:
  - apiKey: []
paths:
  /2022-06-09/collections/{collectionId}/sfts:
    post:
      tags:
        - NFTs
      summary: Mint SFT
      description: |
        Mint your SFTs and deliver them to a web3 wallet or an email address

        **API scope required**: `nfts.create`
      operationId: mint-sft
      parameters:
        - $ref: '#/components/parameters/idempotencyKeyHeader'
        - $ref: '#/components/parameters/collectionId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - templateId
                - recipient
              properties:
                templateId:
                  type: string
                  description: Identifier of the template
                  example: silver-pass
                recipient:
                  $ref: '#/components/schemas/Recipient'
                sendNotification:
                  $ref: '#/components/schemas/SendNotification'
                locale:
                  $ref: '#/components/schemas/Locale'
                amount:
                  type: integer
                  description: (Optional) Amount to mint
                  example: 10
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  actionId:
                    type: string
                    example: a91c15e3-60f2-4a45-bf1a-cee508981667
                  action:
                    type: string
                    example: nfts.create
                  status:
                    type: string
                    example: pending
                  data:
                    type: object
                    properties:
                      chain:
                        type: string
                        example: polygon
                      collection:
                        type: object
                        properties:
                          id:
                            type: string
                            example: 84e3d617-9c1b-4e7a-9686-522a9ea7c520
                          contractAddress:
                            type: string
                            example: '0x9b8ab8949bd7E73E61945b88F7fe12151f98ad3C'
                      recipient:
                        type: object
                        properties:
                          walletAddress:
                            type: string
                            example: '0xcFDc00Cf926A5053f9Cdf004e6DF17e6dEB2E146'
                          email:
                            type: string
                            example: testy@crossmint.com
                      token:
                        type: object
                        properties:
                          id:
                            type: string
                            example: a91c15e3-60f2-4a45-bf1a-cee508981667
                  startedAt:
                    type: string
                    example: '2024-01-02T22:05:01.000Z'
                  resource:
                    type: string
                    example: >-
                      https://staging.crossmint.com/api/2022-06-09/actions/a91c15e3-60f2-4a45-bf1a-cee508981667
        '400':
          description: >-
            Invalid arguments, please make sure you're following the api
            specification.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400Response'
        '403':
          description: Forbidden error, please ensure the credentials are correct.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403Response'
        '404':
          description: Not found error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404Response'
        '503':
          description: >-
            Please try again in a few minutes. If the issue still persists,
            contact Crossmint support.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/503Response'
components:
  parameters:
    idempotencyKeyHeader:
      name: x-idempotency-key
      in: header
      description: Unique identifier to prevent duplicate requests
      schema:
        type: string
    collectionId:
      name: collectionId
      in: path
      description: >
        This is the identifier for the collection related to the request. Every
        project has default collections: `default-solana` and
        `default-polygon`. 


        The
        [create-collection](/api-reference/minting/collection/create-collection)
        API will result in collections with UUID formatted `collectionId`. 

        **Example:** `9c82ef99-617f-497d-9abb-fd355291681b`


        The
        [create-collection-idempotent](/api-reference/minting/collection/create-collection-idempotent)
        API allows you to specify an arbitrary identifier during the initial
        request.

        **Example:** `your-custom-identifier`
      required: true
      example: default-solana
      schema:
        type: string
  schemas:
    Recipient:
      type: string
      example: email:testy@crossmint.com:polygon
      description: |
        Allowed formats: 

        `<chain>:<address>` or 

        `email:<email_address>:<chain>` or

        `userId:<userId>:<chain>` or

        `twitter:<twitter_handle>:<chain>`

        [see here for more info](/minting/nfts/integrate/manage-delivery)
    SendNotification:
      type: boolean
      description: >-
        Notify recipient via email notification about successful mint [Default:
        true]. For legacy projects created before Sep 16, 2024, this is set to
        false by default.
    Locale:
      type: string
      example: en-US
      description: 'Specify the locale for the email content [Default: en-US]'
    400Response:
      type: object
      properties:
        error:
          type: boolean
          example: true
        message:
          type: string
          example: Invalid arguments or empty parameter <missing parameter>.
    403Response:
      type: object
      properties:
        error:
          type: boolean
          example: true
        message:
          type: string
          example: Malformed API key. / API key provided doesn't have required scopes.
    404Response:
      type: object
      properties:
        error:
          type: boolean
          example: true
        message:
          type: string
          example: Not found
    503Response:
      type: object
      properties:
        error:
          type: boolean
          example: true
        message:
          type: string
          example: >-
            Please try again in a few minutes. If the issue still persists,
            contact Crossmint support.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Obtained in the Crossmint developer console

````