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

# Create Token

> Register a new token for the project. The token contract must already be deployed on-chain.

Register a new token for your project. This records token metadata in Magna —
the token contract must already be deployed on-chain. Use
[List Chains](/apis/admin/chains/chains-list) to look up the `chainId` for your network.

**Route:** `POST /api/external/v1/tokens/create`

## Headers

| Header              | Required | Description                |
| ------------------- | -------- | -------------------------- |
| `Content-Type`      | Yes      | Must be `application/json` |
| `x-magna-api-token` | Yes      | Your Magna API token       |

## Body parameters

| Field         | Type               | Required | Description                                              |
| ------------- | ------------------ | -------- | -------------------------------------------------------- |
| `symbol`      | string             | Yes      | Token ticker symbol (e.g. `"USDC"`)                      |
| `chainId`     | string (uuid)      | Yes      | Magna chain ID (from `GET /chains`)                      |
| `decimals`    | number (int, 0–18) | Yes      | Number of decimal places (typically 18 for ERC-20)       |
| `address`     | string \| null     | No       | On-chain contract address; omit/null if not yet deployed |
| `usdPrice`    | number             | No       | Current USD price                                        |
| `totalSupply` | number             | No       | Total on-chain supply                                    |
| `logo`        | string             | No       | URL to the token logo image                              |
| `mintDate`    | string (ISO 8601)  | No       | Mint / TGE date                                          |
| `isNative`    | boolean            | No       | Whether this is the chain's native gas token             |

## Request example

```sh theme={null}
curl -X POST https://app.magna.so/api/external/v1/tokens/create \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_API_KEY' \
-d '{
  "symbol": "MAGNA",
  "chainId": "ch...uuid",
  "decimals": 18,
  "address": "0x...",
  "usdPrice": 1.25
}'
```

## Response example

```json theme={null}
{
  "id": "tok...uuid",
  "symbol": "MAGNA",
  "chainId": "ch...uuid",
  "address": "0x...",
  "decimals": 18,
  "usdPrice": 1.25,
  "totalSupply": null,
  "logo": null,
  "mintDate": null,
  "isNative": false,
  "projectId": "p...uuid",
  "createdAt": "2024-04-15T21:26:21.000Z"
}
```