> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools-and-resources/api-reference/token-related-apis-for-asynchronous-execution/token-creation.md).

# Token Creation

**`POST /tokens/push`**

Creates a new Hedera token asynchronously. Only users with the Standard Registry role are allowed to make this request.

**Authentication:** Bearer token required (`Authorization: Bearer <token>`)

**Permission:** `Permissions.TOKENS_TOKEN_CREATE`

***

## Request

### Request Body

```json
{
  "tokenName": "Example Token",
  "tokenSymbol": "ET",
  "tokenType": "fungible",
  "decimals": 2,
  "initialSupply": 0,
  "enableAdmin": true,
  "changeSupply": true,
  "enableFreeze": true,
  "enableKYC": true,
  "enableWipe": true
}
```

| Field           | Type    | Required | Description                              |
| --------------- | ------- | -------- | ---------------------------------------- |
| `tokenName`     | string  | Yes      | Name of the token                        |
| `tokenSymbol`   | string  | Yes      | Symbol of the token                      |
| `tokenType`     | string  | Yes      | Token type: `fungible` or `non-fungible` |
| `decimals`      | number  | No       | Number of decimal places (fungible only) |
| `initialSupply` | number  | No       | Initial supply amount                    |
| `enableAdmin`   | boolean | No       | Whether admin key is enabled             |
| `changeSupply`  | boolean | No       | Whether supply can be changed            |
| `enableFreeze`  | boolean | No       | Whether freeze key is enabled            |
| `enableKYC`     | boolean | No       | Whether KYC key is enabled               |
| `enableWipe`    | boolean | No       | Whether wipe key is enabled              |

***

## Response

### Success Response

**Status:** `202 Accepted`

```json
{
  "taskId": "63e3e5e8a01b3c001234abcd",
  "expectation": "Create token"
}
```

Poll `GET /tasks/{taskId}` to retrieve the result.

### Error Responses

| Status                      | Description                     |
| --------------------------- | ------------------------------- |
| `401 Unauthorized`          | Missing or invalid token        |
| `403 Forbidden`             | Insufficient permissions        |
| `422 Unprocessable Entity`  | User not registered with Hedera |
| `500 Internal Server Error` | Unexpected server failure       |