---
title: "Create Collection with ID"
method: PUT
path: "/2022-06-09/collections/{collectionId}"
tags: ["NFT Collections"]
---

# Create Collection with ID

`PUT /2022-06-09/collections/{collectionId}`

Create a collection that you can mint NFTs/SFTs from. This API is idempotent, 
if you call it multiple times with the same ID, only one will be created.

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

## Path parameters

- `collectionId` string, required

## Request body

- CreateCollectionBody
  - `chain` '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', required — Blockchain you would like to use for this collection
  - `metadata` object, required
    - `name` string, required — Collection name (Max length: 32)
    - `imageUrl` string — URL pointing to an image that represents the collection
    - `description` string, required — A description of the NFT collection
    - `symbol` string — Shorthand identifier for the NFT collection (Max length: 10). Defaults to 'TOKEN'
  - `fungibility` 'non-fungible' | 'semi-fungible' — Whether or not this collection is fungible. EVM and Solana collections may be set as semi-fungible.
  - `transferable` boolean — Whether or not NFTs in this collection are transferable. Supported on EVM and Aptos chains. (For subscriptions must be set to false)
  - `supplyLimit` number — The maximum number of tokens that can be minted for this collection
  - `payments` PaymentsObject — Enable payments for this collection by setting `price`, `recipientAddress` and `currency`
    - `price` string — The price of the token in native currency for the selected chain
    - `recipientAddress` string — The wallet address to receive payouts
    - `currency` string — The currency for the price of the NFT. Defaults to the native currency of the chain
  - `subscription` object
    - `enabled` boolean — Whether subscriptions are enabled for this collection
  - `reuploadLinkedFiles` boolean — Any URLs in the metadata object will be resolved and reuploaded to IPFS [Default: true]

## Response `200`

Success.

- CreateCollectionResponse
  - `id` string
  - `metadata` object
    - `name` string
    - `description` string
    - `imageUrl` string
    - `symbol` string
  - `fungibility` string
  - `onChain` object
    - `chain` string
    - `type` string
  - `actionId` string
  - `subscription` object
    - `enabled` boolean

## Other responses

- `400` — Invalid arguments, please make sure you're following the api specification.
- `403` — Forbidden error, please ensure the credentials are correct.
- `404` — Not found error.
- `503` — Please try again in a few minutes. If the issue still persists, contact Crossmint support.

---

[API](https://skmtc.net/crossmint/apis/onramp.md) · [All operations](https://skmtc.net/crossmint/apis/onramp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crossmint/onramp/revisions/e2143d192130/schema)