---
title: "POST /coins"
method: POST
path: "/coins"
tags: ["coins"]
---

# POST /coins

`POST /coins`

Creates a new artist coin

## Query parameters

- `user_id` string, required

## Request body

- CreateCoinRequest
  - `mint` string, required — The mint address of the coin
  - `ticker` string, required — The coin symbol/ticker
  - `decimals` integer, required — The number of decimals for the coin (0-18)
  - `name` string, required — The coin name
  - `logo_uri` string — The URI for the coin's logo image
  - `banner_image_url` string, uri — The URI for the coin's banner image
  - `description` string — The description of the coin
  - `link_1` string, uri — Generic link URL for the coin
  - `link_2` string, uri — Generic link URL for the coin
  - `link_3` string, uri — Generic link URL for the coin
  - `link_4` string, uri — Generic link URL for the coin

## Response `201`

Success - Coin created

- CreateCoinResponse
  - `data` object
    - `mint` string, required — The mint address of the coin
    - `ticker` string, required — The coin symbol/ticker
    - `user_id` integer, required — The user ID who created the coin
    - `decimals` integer, required — The number of decimals for the coin
    - `name` string, required — The coin name
    - `logo_uri` string — The URI for the coin's logo image
    - `banner_image_url` string — The URI for the coin's banner image
    - `description` string — The description of the coin
    - `link_1` string — Generic link URL for the coin
    - `link_2` string — Generic link URL for the coin
    - `link_3` string — Generic link URL for the coin
    - `link_4` string — Generic link URL for the coin
    - `created_at` string, date-time, required — The date and time when the coin was created

## Other responses

- `400` — Bad request - Invalid parameters
- `500` — Server error

---

[API](https://skmtc.dev/audius/apis/audius-api.md) · [All operations](https://skmtc.dev/audius/apis/audius-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/audius/audius-api/revisions/940230b2ed3d/schema)