Create a Collection

Create a Collection

This endpoint allows you to create a new Collection.

POSThttps://api.underdogprotocol.com/v1/collections

Authorization

bearerAuth

Body

application/json

name*string

Name for you NFT Collection

description*string

Description for your NFT Collection

image*string

URL pointing to an image for your NFT Collection

attributesAttributes for your NFT Collectio

Key-value pairs where the key is the attribute name and the value is the attribute value.

Response

202401403404

Body

application/json

transactionId*string

Transaction ID that identifies the Transaction generated by an API request

mintAddress*string

Address for the NFT's or token's mint account

Example: "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp"

Pattern: ^[A-HJ-NP-Za-km-z1-9]*$

Request

JavaScriptCurlPython

const response = await fetch('https://api.underdogprotocol.com/v1/collections', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "description": "text",
      "image": "text"
    }),
});
const data = await response.json();

Response

202401403404

{
  "transactionId": "text",
  "mintAddress": "EBeLw5jEdrEgDe17BdKGW2MizzGxtxigEuAGvYC7VzDp"
}

Example

cURL

curl -X POST \
        --url https://api.underdogprotocol.com/v1/collections \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer {token}" \
        -d '
{
        "name": "Underdog Protocol",
	"description": "Underdog Protocol Collection",
        "image": "https://underdogprotocol.com/logo-dark.svg"
}'

JavaScript

import axios from 'axios';

const createCollection = async () => {
  try {
    const response = await axios.post('https://api.underdogprotocol.com/v1/collections', {
      name: 'Underdog Protocol',
      description: 'Underdog Protocol Collection',
      image: 'https://underdogprotocol.com/logo-dark.svg'
    }, {
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${token}`
      }
    });

    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Response

{
    "mintAddress": "FrvZAJ1qZ2vhV17nFdEmw66N3FW5QiHFt6HdqsEh8QNq",
    "jobId": "1e10e1e9-e4df-4561-8392-70bdd5ece1d1"
}