{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/wallet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create your first vault","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","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-your-first-vault","__idx":0},"children":["Create your first vault"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A vault is a logical container that groups related wallets together. You must create at least one vault before you can create any wallets."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Plan your vault structure first"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wallets cannot be moved between vaults after creation, and vaults cannot be renamed or deleted. Consider how you want to organize your wallets before you start."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"understand-vault-organization","__idx":1},"children":["Understand vault organization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can organize vaults however you like. A common pattern uses three vaults to separate funds by purpose:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasury vault"]}," — Holds long-term organizational funds. Wallets in this vault only transact with wallets in the Outbound vault. No API credentials have access to this vault, which limits exposure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Outbound vault"]}," — Holds funds earmarked for external transfers. Wallets receive funds from the Treasury vault and send to external addresses. API credentials can access these wallets for programmatic transfers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer vault"]}," — Holds funds on behalf of customers in omnibus-style wallets. These wallets receive deposits from customers and process withdrawals. API credentials can access these wallets for sweep operations."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Start simple in sandbox"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For sandbox testing, a single vault is enough to get started. You can create additional vaults at any time."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-vault","__idx":2},"children":["Create a vault"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vaults"]}," in the sidebar and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create vault"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["name"]}," that identifies the vault's purpose (for example, \"Treasury\" or \"Sandbox Testing\"). Maximum 50 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["description"]}," that explains what the vault is for and what types of wallets it holds. Maximum 100 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Correlation ID"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["External ID"]}," if you use external tracking systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create vault"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The vault appears in your vault list and is ready for wallets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-step","__idx":3},"children":["Next step"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a wallet inside your new vault:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/wallet/getting-started/create-your-first-wallet"},"children":["Create your first wallet"]}]}]}]},"headings":[{"value":"Create your first vault","id":"create-your-first-vault","depth":1},{"value":"Understand vault organization","id":"understand-vault-organization","depth":2},{"value":"Create a vault","id":"create-a-vault","depth":2},{"value":"Next step","id":"next-step","depth":2}],"frontmatter":{"title":"Create your first vault","seo":{"title":"Create your first vault"}},"lastModified":"2026-03-19T14:23:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/wallet/getting-started/create-your-first-vault","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}