> For the complete documentation index, see [llms.txt](https://developer.1moneynetwork.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.1moneynetwork.com/integrations/rest-apis/tokens/issue-token.md).

# Issue token

{% hint style="danger" %}
The 1Money Network Operator will use the issue token API to create the token on the issuer's behalf and grant `master_authority` to the issuer's specified address.
{% endhint %}

## POST /v1/tokens/issue

>

```json
{"openapi":"3.1.0","info":{"title":"om-api-rest","version":"0.1.0"},"tags":[{"name":"tokens","description":"Tokens API"}],"servers":[{"url":"https://api.testnet.1money.network","description":"Testnet API server"},{"url":"https://api.1money.network","description":"Mainnet API server"},{"url":"http://localhost:18555","description":"Local API server"}],"paths":{"/v1/tokens/issue":{"post":{"tags":["tokens"],"operationId":"issue_new_token","requestBody":{"description":"token issue request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenIssueRequest"}}},"required":true},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HashWithToken"}}}},"400":{"description":"Client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"408":{"description":"Request timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"422":{"description":"Business logic error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RESTErrorData"}}}}}}}},"components":{"schemas":{"TokenIssueRequest":{"allOf":[{"$ref":"#/components/schemas/TokenIssuePayload"},{"type":"object","required":["signature"],"properties":{"signature":{"$ref":"#/components/schemas/RestSignature"}}}]},"TokenIssuePayload":{"type":"object","required":["chain_id","nonce","symbol","name","decimals","master_authority","is_private"],"properties":{"chain_id":{"type":"integer","format":"int64","description":"The chain id of the transaction.","minimum":0},"decimals":{"type":"integer","format":"int32","description":"The decimals of the token (maximum 18).","maximum":18,"minimum":0},"is_private":{"type":"boolean","description":"`true` if this token is private and only whitelisted addresses can\noperate with the tokens"},"master_authority":{"$ref":"#/components/schemas/AddressSchema","description":"The master authority of the token."},"name":{"type":"string","description":"The name of the token."},"nonce":{"type":"integer","format":"int64","description":"The nonce of the transaction.","minimum":0},"symbol":{"type":"string","description":"The symbol of the token."}}},"AddressSchema":{"type":"string","title":"string"},"RestSignature":{"type":"object","description":"Signature type for REST requests.\n\nWe use this type to avoid the ambiguity of the signature type in the core\nprimitives.\n\nThis type is referred to `https://github.com/alloy-rs/alloy/blob/b2278c40b2693908e4e5108d65ade26e8d716765/crates/rpc-types-eth/src/transaction/signature.rs#L9`.","required":["r","s","v"],"properties":{"r":{"$ref":"#/components/schemas/SignatureRSchema","description":"The R field of the signature; the point on the curve."},"s":{"$ref":"#/components/schemas/SignatureSSchema","description":"The S field of the signature; the point on the curve."},"v":{"type":"integer","format":"int64","description":"For EIP-155, EIP-2930 and Blob transactions this is set to the parity (0\nfor even, 1 for odd) of the y-value of the secp256k1 signature.\n\nFor legacy transactions, this is the recovery id\n\nSee also <https://ethereum.github.io/execution-apis/api-documentation/> and <https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyhash>","minimum":0}}},"SignatureRSchema":{"type":"string","title":"string","description":"Signature R schema"},"SignatureSSchema":{"type":"string","title":"string","description":"Signature S schema"},"HashWithToken":{"type":"object","description":"Represents a transaction hash and the token that created by the transaction.","required":["hash","token"],"properties":{"hash":{"$ref":"#/components/schemas/B256Schema","description":"The hash of the transaction."},"token":{"$ref":"#/components/schemas/TokenAddressSchema","description":"The token that created by the transaction, only works for issuing new\ntokens."}}},"B256Schema":{"type":"string","title":"string"},"TokenAddressSchema":{"type":"string","title":"string"},"RESTErrorData":{"type":"object","required":["error_code","message"],"properties":{"error_code":{"type":"string","description":"Structured error code for programmatic handling"},"message":{"type":"string","description":"Human-readable error message"}}}}}}
```