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

# POST Tokens

> Create a token

<Note>This API requires the `apps` scope</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X 'POST' \
    'https://api.bitski.com/v1/apps/{appId}/tokens' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <ACCESS_TOKEN>' \
    -d '{
    "initialOwner": "0xa4ef984773fd233c4cbed9cb1b905a3fa21e9461",
    "token": {
      "contractId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "image": "https://cdn.bitskistatic.com/tokens-raw/54676382-bab5-408d-afe2-fc6f160da4a8/06fd0294-a425-44c7-96e8-9d24757163b4.png",
      "description": "A great token",
      "metadata": {
        "description": "A very special NFT",
        "external_url": "https://www.bitski.com/@Stapleverse",
        "image": "https://cdn.bitskistatic.com/tokens-raw/54676382-bab5-408d-afe2-fc6f160da4a8/06fd0294-a425-44c7-96e8-9d24757163b4.png",
        "name": "NFT Token #1",
        "properties": {},
      },
      "name": "Bird NFT",
      "state": "AVAILABLE",
      "tokenId": "0x1",
      "tokenTemplateId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    },
    "transaction": {
      "from": "0xa4ef984773fd233c4cbed9cb1b905a3fa21e9461",
      "gas": "0xd9cb1b905",
      "gasPrice": "0xe8cb1b9"
    }
  }'
  ```
</RequestExample>

### Path

<ParamField path="appId" type="string" required>
  Your Bitski Application ID
</ParamField>

### Response

<ResponseField name="token" type="object" required>
  <Expandable title="properties">
    <ResponseField name="id" type="string" required />

    <ResponseField name="tokenTemplateId" type="string" required />

    <ResponseField name="name" type="string" required />

    <ResponseField name="animationUrl" type="string" />

    <ResponseField name="backgroundColor" type="string" />

    <ResponseField name="youtubeUrl" type="string" />

    <ResponseField name="createdAt" type="string" required />

    <ResponseField name="description" type="string" required />

    <ResponseField name="externalUrl" type="string" />

    <ResponseField name="image" type="string" />

    <ResponseField name="index" type="string" required />

    <ResponseField name="metadata" type="object" required />

    <ResponseField name="privateMetadata" type="object" required />

    <ResponseField name="state" type="string" required />
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Sample Response theme={null}
  {
    "tokens": [
      {
        "animationUrl": null,
        "backgroundColor": "#ff1122",
        "createdAt": "2023-04-26T20:42:11.878Z",
        "description": "Interesting bird NFT",
        "externalUrl": "https://www.bitski.com/@Stapleverse",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "image": "https://cdn.bitskistatic.com/tokens-raw/54676382-bab5-408d-afe2-fc6f160da4a8/06fd0294-a425-44c7-96e8-9d24757163b4.png",
        "index": "0x3",
        "metadata": {
          "animation_url": null,
          "background_color": null,
          "description": "A very special NFT",
          "external_url": "https://www.bitski.com/@Stapleverse",
          "image": "https://cdn.bitskistatic.com/tokens-raw/54676382-bab5-408d-afe2-fc6f160da4a8/06fd0294-a425-44c7-96e8-9d24757163b4.png",
          "name": "NFT Token #1",
          "properties": {},
          "youtube_url": null
        },
        "name": "Bird #1",
        "privateMetadata": {},
        "state": "MINTED",
        "tokenTemplateId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "youtubeUrl": null
      }
    ]
  }
  ```
</ResponseExample>