{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create an MPT issuance","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-an-mpt-issuance","__idx":0},"children":["Create an MPT issuance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a new Multi-Purpose Token (MPT) issuance on the XRP Ledger."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An XRPL account registered in ","Ripple Custody"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sufficient XRP for reserves (owner reserve + issuance reserve)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-an-mpt-issuance-1","__idx":2},"children":["Create an MPT issuance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create an MPT, submit a transaction order with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTokenIssuanceCreate"]}," operation:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"payload\": {\n    \"id\": \"{{intent_id}}\",\n    \"accountId\": \"{{issuer_account_id}}\",\n    \"ledgerId\": \"xrpl-testnet\",\n    \"parameters\": {\n      \"type\": \"XRPL\",\n      \"feeStrategy\": {\n        \"priority\": \"High\",\n        \"type\": \"Priority\"\n      },\n      \"maximumFee\": \"1000000000\",\n      \"memos\": [],\n      \"operation\": {\n        \"type\": \"MPTokenIssuanceCreate\",\n        \"assetScale\": 6,\n        \"transferFee\": 0,\n        \"maximumAmount\": \"1000000000000000\",\n        \"metadata\": {\n          \"type\": \"HexEncodedMetadata\",\n          \"value\": \"7B226E223A224D7920546F6B656E222C2264223A22546F6B656E206465736372697074696F6E227D\"\n        },\n        \"flags\": [\"tfMPTCanTransfer\", \"tfMPTCanTrade\", \"tfMPTCanClawback\", \"tfMPTCanLock\"]\n      }\n    },\n    \"description\": \"MPTokenIssuanceCreate intent\",\n    \"customProperties\": {},\n    \"type\": \"v0_CreateTransactionOrder\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.value"]}," field contains hex-encoded JSON. The example above decodes to: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"n\":\"My Token\",\"d\":\"Token description\"}"]},". Use a hex encoding utility to convert your metadata JSON to hex format."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parameters","__idx":3},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issuance flags. Can be empty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[]"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#issuance-flags"},"children":["Issuance flags"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["assetScale"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Decimal precision (0-255). Default: 0"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maximumAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum supply (64-bit unsigned integer as string). Omit for unlimited."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transferFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer fee in basis points (0-50000)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hex-encoded on-chain metadata. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#metadata-format"},"children":["Metadata format"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"metadata-format","__idx":4},"children":["Metadata format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," field must be an object with the following structure:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HexEncodedMetadata"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hex-encoded metadata string."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"issuance-flags","__idx":5},"children":["Issuance flags"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set these flags during creation to control token behavior. These flags are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["immutable"]}," after creation."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Flag"},"children":["Flag"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTCanLock"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issuer can freeze tokens."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTRequireAuth"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Holders must be authorized before receiving tokens."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTCanTransfer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Holders can transfer tokens to each other."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTCanClawback"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issuer can reclaim tokens from holders."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTCanEscrow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokens can be placed in escrow."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTCanTrade"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokens can be traded on the DEX."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tfMPTConfidential"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enable confidential mode (cMPT)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose flags carefully during issuance. Most flags cannot be changed after the MPT is created."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":6},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns the transaction order with status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pending"]},". The transaction includes the generated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTIssuanceID"]}," in the on-chain result after confirmation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-the-issuance-id","__idx":7},"children":["Retrieve the issuance ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the transaction is confirmed, retrieve the issuance ID from the transaction result:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Query the transaction order by ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extract the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MPTIssuanceID"]}," from the ledger result."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The issuance ID is a 192-bit identifier (48 hex characters) used to reference the MPT in all subsequent operations."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-topics","__idx":8},"children":["Related topics"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts#supported-operations"},"children":["Multi-purpose tokens"]}," — Overview of MPT operations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts"},"children":["Multi-purpose tokens concepts"]}," — Conceptual information about MPTs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts/issuer/mint"},"children":["Mint tokens"]}," — Issue tokens to holders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts#token-flags"},"children":["Token flags"]}," — Flag descriptions and risk impact."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://xrpl.org/docs/references/protocol/transactions/types/mptokenissuancecreate","target":"_blank"},"children":["MPTokenIssuanceCreate"]}," — XRPL transaction reference."]}]}]},"headings":[{"value":"Create an MPT issuance","id":"create-an-mpt-issuance","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Create an MPT issuance","id":"create-an-mpt-issuance-1","depth":2},{"value":"Parameters","id":"parameters","depth":2},{"value":"Metadata format","id":"metadata-format","depth":2},{"value":"Issuance flags","id":"issuance-flags","depth":2},{"value":"Response","id":"response","depth":2},{"value":"Retrieve the issuance ID","id":"retrieve-the-issuance-id","depth":2},{"value":"Related topics","id":"related-topics","depth":2}],"frontmatter":{"seo":{"title":"Create an MPT issuance"}},"lastModified":"2026-07-27T10:10:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.38/accounts-and-assets/tokenization/xrpl-mpts/issuer/create-issuance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}