> ## 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.

# Create Collection

> Create a collection that you can mint NFTs/SFTs from

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




## OpenAPI

````yaml post /2022-06-09/collections/
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/:
    post:
      tags:
        - NFT Collections
      summary: Create Collection
      description: |
        Create a collection that you can mint NFTs/SFTs from

        **API scope required**: `collections.create`
      operationId: create-collection
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCollectionBody'
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCollectionResponse'
        '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:
  schemas:
    CreateCollectionBody:
      type: object
      additionalProperties: false
      properties:
        chain:
          description: Blockchain you would like to use for this collection
          type: string
          example: polygon
          enum:
            - aptos
            - arbitrum
            - arbitrum-sepolia
            - avalanche
            - avalanche-fuji
            - base
            - base-sepolia
            - bsc
            - chiliz
            - chiliz-spicy-testnet
            - ethereum
            - ethereum-sepolia
            - optimism
            - optimism-sepolia
            - polygon
            - polygon-amoy
            - shape
            - shape-sepolia
            - skale-nebula
            - skale-nebula-testnet
            - solana
            - soneium-minato-testnet
            - xai
            - xai-sepolia-testnet
            - zora
            - zora-sepolia
        metadata:
          type: object
          additionalProperties: false
          required:
            - name
            - description
          properties:
            name:
              type: string
              description: 'Collection name (Max length: 32)'
              example: Sample NFT Collection
              maxLength: 32
            imageUrl:
              type: string
              description: URL pointing to an image that represents the collection
              example: https://www.crossmint.com/assets/crossmint/logo.png
            description:
              type: string
              description: A description of the NFT collection
              example: This is a sample NFT collection
              maxLength: 64
            symbol:
              type: string
              description: >-
                Shorthand identifier for the NFT collection (Max length: 10).
                Defaults to 'TOKEN'
              example: TOKEN
              maxLength: 10
        fungibility:
          description: >-
            Whether or not this collection is fungible. EVM and Solana
            collections may be set as semi-fungible.
          type: string
          enum:
            - non-fungible
            - semi-fungible
          default: non-fungible
        transferable:
          description: >-
            Whether or not NFTs in this collection are transferable. Supported
            on EVM and Aptos chains. (For subscriptions must be set to false)
          type: boolean
          default: true
        supplyLimit:
          type: number
          description: The maximum number of tokens that can be minted for this collection
        payments:
          $ref: '#/components/schemas/PaymentsObject'
        subscription:
          type: object
          additionalProperties: false
          properties:
            enabled:
              type: boolean
              description: Whether subscriptions are enabled for this collection
              default: false
              example: false
        reuploadLinkedFiles:
          $ref: '#/components/schemas/ReuploadLinkedFiles'
      required:
        - chain
        - metadata
    CreateCollectionResponse:
      type: object
      properties:
        id:
          type: string
          example: 5263650e-6d43-4ed3-9e31-0cf593d076a4
        metadata:
          type: object
          properties:
            name:
              type: string
              example: Sample NFT Collection
            description:
              type: string
              example: This is a sample NFT collection
            imageUrl:
              type: string
              example: https://www.crossmint.com/assets/crossmint/logo.png
            symbol:
              type: string
              example: TOKEN
        fungibility:
          type: string
          example: non-fungible
        onChain:
          type: object
          properties:
            chain:
              type: string
              example: polygon
            type:
              type: string
              example: erc-721
        actionId:
          type: string
          example: 5263650e-6d43-4ed3-9e31-0cf593d076a4
        subscription:
          type: object
          properties:
            enabled:
              type: boolean
    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.
    PaymentsObject:
      type: object
      additionalProperties: false
      description: >-
        Enable payments for this collection by setting `price`,
        `recipientAddress` and `currency`
      properties:
        price:
          type: string
          description: The price of the token in native currency for the selected chain
        recipientAddress:
          type: string
          description: The wallet address to receive payouts
        currency:
          type: string
          description: >-
            The currency for the price of the NFT. Defaults to the native
            currency of the chain
    ReuploadLinkedFiles:
      type: boolean
      description: >-
        Any URLs in the metadata object will be resolved and reuploaded to IPFS
        [Default: true]
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Obtained in the Crossmint developer console

````