{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Daimo","colors":{"primary":"#009110","light":"#6fba6c","dark":"#127b17"},"logo":{"light":"https://mintcdn.com/daimo/9lH0w9xCPumaY8Il/logo.svg?fit=max\u0026auto=format\u0026n=9lH0w9xCPumaY8Il\u0026q=85\u0026s=64db2bb549081a11580068f5169bdf5a","dark":"https://mintcdn.com/daimo/9lH0w9xCPumaY8Il/logo-dark.svg?fit=max\u0026auto=format\u0026n=9lH0w9xCPumaY8Il\u0026q=85\u0026s=dacd44f92cafcfcf4a79c2744cb94be7"},"favicon":"https://mintcdn.com/daimo/9lH0w9xCPumaY8Il/favicon.svg?fit=max\u0026auto=format\u0026n=9lH0w9xCPumaY8Il\u0026q=85\u0026s=db5cd79782ff6a218bb97c98b01049fb","styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"daimo","hasAudioNarration":false,"actualSubdomain":"daimo","customDomains":["docs.daimo.com"],"gitSource":{"type":"github","owner":"daimo-eth","repo":"daimo-internal","deployBranch":"master","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af633bdc9aed49005cc059a","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Guide","count":16},{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Accept Deposits","count":9},{"language":"default","tag":"Webhooks","count":5},{"language":"default","tag":"Sessions","count":4},{"language":"default","tag":"Advanced","count":3},{"language":"default","tag":"Getting Started","count":2},{"language":"default","tag":"Overview","count":1},{"language":"default","tag":"Withdrawals","count":1},{"language":"default","tag":"Resources","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-session","slug":"/api-reference/create-session","pageMetadata":{"title":"Create session","description":"Creates a new deposit session. Returns the session object including a client secret for client-side operations.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sessions","href":"/api-reference/create-session","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create session","description":"Creates a new deposit session. Returns the session object including a client secret for client-side operations.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sessions","href":"/api-reference/create-session","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create session","description":"Creates a new deposit session. Returns the session object including a client secret for client-side operations.","security":["8c0b933c-b57a-4698-ba2a-ba375f61af04"],"requestBody":"bc9e9464-42da-42a8-872c-610ae521fa53","responses":{"201":"e68b0b22-134b-4b0e-9def-4f539338e082","400":"95eb8836-6755-4eea-8748-4c16087ced13","401":"bcffec42-7624-4e40-bad7-d753c74127b9"},"method":"post","type":"path","servers":["b96ac1b4-d6b8-4971-a9c7-00c2fbf6d8d9"],"path":"/v1/sessions","baseUrlOptions":["https://api.daimo.com"],"title":"Create session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"destination":{"oneOf":[{"type":"object","required":["type","address","chainId","tokenAddress"],"properties":{"type":{"type":"string","enum":["evm"],"description":"Always \"evm\"","isRequired":true,"uniqueKey":"destination.oneOf.0.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Checksummed destination address","isRequired":true,"uniqueKey":"destination.oneOf.0.address","typeLabel":"string"},"chainId":{"type":"number","description":"Destination chain ID (e.g. 8453 for Base)","example":8453,"isRequired":true,"uniqueKey":"destination.oneOf.0.chainId","typeLabel":"number"},"tokenAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Checksummed destination token address","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","isRequired":true,"uniqueKey":"destination.oneOf.0.tokenAddress","typeLabel":"string"},"amountUnits":{"type":"string","description":"Fixed deposit amount in token units (e.g. \"10.00\" for $10 USDC)","example":"10.00","uniqueKey":"destination.oneOf.0.amountUnits","typeLabel":"string"},"calldata":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hex-encoded calldata for a contract call on the destination address","uniqueKey":"destination.oneOf.0.calldata","typeLabel":"string"}},"isRequired":true,"uniqueKey":"destination.oneOf.0","typeLabel":"object"},{"type":"object","required":["type","address","tokenAddress"],"properties":{"type":{"type":"string","enum":["solana"],"description":"Always \"solana\"","isRequired":true,"uniqueKey":"destination.oneOf.1.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Base58 destination address","isRequired":true,"uniqueKey":"destination.oneOf.1.address","typeLabel":"string"},"tokenAddress":{"type":"string","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Destination token mint (base58). USDC only.","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","isRequired":true,"uniqueKey":"destination.oneOf.1.tokenAddress","typeLabel":"string"},"amountUnits":{"type":"string","description":"Fixed deposit amount in token units (e.g. \"10.00\" for $10 USDC)","example":"10.00","uniqueKey":"destination.oneOf.1.amountUnits","typeLabel":"string"}},"isRequired":true,"uniqueKey":"destination.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","address","tokenAddress"],"properties":{"type":{"type":"string","enum":["tron"],"description":"Always \"tron\"","isRequired":true,"uniqueKey":"destination.oneOf.2.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Base58 destination address","isRequired":true,"uniqueKey":"destination.oneOf.2.address","typeLabel":"string"},"tokenAddress":{"type":"string","enum":["TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"],"description":"Destination token address (base58). USDT only.","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","isRequired":true,"uniqueKey":"destination.oneOf.2.tokenAddress","typeLabel":"enum\u003cstring>"},"amountUnits":{"type":"string","description":"Fixed deposit amount in token units (e.g. \"10.00\" for $10 USDT)","example":"10.00","uniqueKey":"destination.oneOf.2.amountUnits","typeLabel":"string"}},"isRequired":true,"uniqueKey":"destination.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"display":{"type":"object","properties":{"title":{"type":"string","description":"Title shown in the deposit modal","example":"Deposit to Acme","isRequired":true,"uniqueKey":"display.title","typeLabel":"string"},"verb":{"type":"string","description":"One-word verb for CTAs (e.g. \"Deposit\")","example":"Deposit","isRequired":true,"uniqueKey":"display.verb","typeLabel":"string"},"themeCssUrl":{"type":"string","description":"URL to a custom theme CSS file","uniqueKey":"display.themeCssUrl","typeLabel":"string"},"paymentMethods":{"oneOf":[{"type":"object","description":"Payment method selector. `{ \"mode\": \"auto\" }` shows Daimo's localized payment picker. `{ \"mode\": \"fixed\", \"type\": \"Coinbase\" }` pins the session to one payment method. Mutually exclusive with paymentOptions.","required":["mode"],"properties":{"mode":{"type":"string","enum":["auto"],"isRequired":true,"uniqueKey":"display.paymentMethods.oneOf.0.mode","typeLabel":"enum\u003cstring>"}},"uniqueKey":"display.paymentMethods.oneOf.0","typeLabel":"object"},{"type":"object","description":"Payment method selector. `{ \"mode\": \"auto\" }` shows Daimo's localized payment picker. `{ \"mode\": \"fixed\", \"type\": \"Coinbase\" }` pins the session to one payment method. Mutually exclusive with paymentOptions.","required":["mode","type"],"properties":{"mode":{"type":"string","enum":["fixed"],"isRequired":true,"uniqueKey":"display.paymentMethods.oneOf.1.mode","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["ConnectedWallet","Interac","ACH","SEPA","ApplePay","GooglePay","CashApp","Coinbase","Binance","Lemon","BitgetExchange","BybitExchange","MtPelerin","Tron","ARS","BreB","JPYC","Stripe","RevolutRamp"],"isRequired":true,"uniqueKey":"display.paymentMethods.oneOf.1.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"display.paymentMethods.oneOf.1","typeLabel":"object"}],"uniqueKey":"display.paymentMethods","typeLabel":"object"},"paymentOptions":{"type":"array","items":{"oneOf":[{"type":"string","enum":["AllWallets","AllExchanges","AllFiat","AllBank","AllAddresses","ConnectedWallet","AutoconnectInjectedWallets","MetaMask","Trust","Phantom","Rainbow","BaseApp","Bitget","BitgetWallet","OKX","Zerion","Rabby","Backpack","Solflare","Coinbase","Binance","BinanceUSDC","BinanceUSDT","Lemon","BitgetExchange","BybitExchange","MtPelerin","CashApp","Stripe","RevolutRamp","Tron","Interac","ApplePay","GooglePay","ACH","SEPA","JPYC","ARS","BreB","AccountDeposit","ExternalChains","Daimo","World","Family","Farcaster","MiniPay","Revolut","Wise","MercadoPago","Venmo","AllPaymentApps","Solana"],"uniqueKey":"display.paymentOptions.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"array","items":{"type":"string","enum":["AllWallets","AllExchanges","AllFiat","AllBank","AllAddresses","ConnectedWallet","AutoconnectInjectedWallets","MetaMask","Trust","Phantom","Rainbow","BaseApp","Bitget","BitgetWallet","OKX","Zerion","Rabby","Backpack","Solflare","Coinbase","Binance","BinanceUSDC","BinanceUSDT","Lemon","BitgetExchange","BybitExchange","MtPelerin","CashApp","Stripe","RevolutRamp","Tron","Interac","ApplePay","GooglePay","ACH","SEPA","JPYC","ARS","BreB","AccountDeposit","ExternalChains","Daimo","World","Family","Farcaster","MiniPay","Revolut","Wise","MercadoPago","Venmo","AllPaymentApps","Solana"],"uniqueKey":"display.paymentOptions.items.[INDEX].oneOf.1.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"display.paymentOptions.items.[INDEX].oneOf.1","typeLabel":"enum\u003cstring>[]"}],"uniqueKey":"display.paymentOptions.items.[INDEX]","typeLabel":"enum\u003cstring> | enum\u003cstring>[]"},"description":"Deprecated: use paymentMethods. Control which payment methods appear and in what order","deprecated":true,"uniqueKey":"display.paymentOptions","typeLabel":"(enum\u003cstring> | enum\u003cstring>[])[]"}},"required":["title","verb"],"isRequired":true,"uniqueKey":"display","typeLabel":"object"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.additionalProperties","typeLabel":"string"},"description":"Key-value string pairs for your own use. For fiat sessions, set `email` to start at email OTP, or `phone` as an E.164 phone hint for Apple Pay.","example":{"email":"account@daimo.com","phone":"+14155552671","orderId":"123"},"uniqueKey":"metadata","typeLabel":"object"},"refundAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address to receive funds if a contract call reverts","uniqueKey":"refundAddress","typeLabel":"string"}},"required":["destination","display"],"uniqueKey":"","typeLabel":"object"},"example":{"destination":{"type":"evm","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":8453,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amountUnits":"10.00"},"display":{"title":"Deposit to Acme","verb":"Deposit"}},"examples":{"Example":{"title":"Example","value":{"destination":{"type":"evm","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":8453,"tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amountUnits":"10.00"},"display":{"title":"Deposit to Acme","verb":"Deposit"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e68b0b22-134b-4b0e-9def-4f539338e082":{"description":"Session created","content":{"application/json":{"schema":{"type":"object","properties":{"session":{"type":"object","required":["metadata","clientSecret","sessionId","status","destination","display","paymentMethod","createdAt","expiresAt"],"properties":{"sessionId":{"type":"string","description":"Session ID","isRequired":true,"uniqueKey":"session.sessionId","typeLabel":"string"},"status":{"type":"string","enum":["requires_payment_method","waiting_payment","processing","succeeded","bounced","expired"],"description":"Current session status","example":"requires_payment_method","isRequired":true,"uniqueKey":"session.status","typeLabel":"enum\u003cstring>"},"destination":{"oneOf":[{"type":"object","required":["type","address","chainId","chainName","tokenAddress","tokenSymbol"],"properties":{"type":{"type":"string","enum":["evm"],"description":"Always \"evm\"","isRequired":true,"uniqueKey":"session.destination.oneOf.0.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Destination address","isRequired":true,"uniqueKey":"session.destination.oneOf.0.address","typeLabel":"string"},"chainId":{"type":"number","description":"Destination chain ID","example":8453,"isRequired":true,"uniqueKey":"session.destination.oneOf.0.chainId","typeLabel":"number"},"chainName":{"type":"string","description":"Destination chain name","example":"Base","isRequired":true,"uniqueKey":"session.destination.oneOf.0.chainName","typeLabel":"string"},"tokenAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Destination token address","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","isRequired":true,"uniqueKey":"session.destination.oneOf.0.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","description":"Destination token symbol","example":"USDC","isRequired":true,"uniqueKey":"session.destination.oneOf.0.tokenSymbol","typeLabel":"string"},"amountUnits":{"type":"string","description":"Requested amount in token units","example":"10.00","uniqueKey":"session.destination.oneOf.0.amountUnits","typeLabel":"string"},"calldata":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hex-encoded calldata for contract calls","uniqueKey":"session.destination.oneOf.0.calldata","typeLabel":"string"},"delivery":{"type":"object","properties":{"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Delivery transaction hash","isRequired":true,"uniqueKey":"session.destination.oneOf.0.delivery.txHash","typeLabel":"string"},"receivedUnits":{"type":"string","description":"Amount actually received","isRequired":true,"uniqueKey":"session.destination.oneOf.0.delivery.receivedUnits","typeLabel":"string"}},"required":["txHash","receivedUnits"],"description":"Set once funds are delivered","uniqueKey":"session.destination.oneOf.0.delivery","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.destination.oneOf.0","typeLabel":"object"},{"type":"object","required":["type","address","tokenAddress","tokenSymbol"],"properties":{"type":{"type":"string","enum":["solana"],"description":"Always \"solana\"","isRequired":true,"uniqueKey":"session.destination.oneOf.1.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","description":"Destination address (base58)","example":"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU","isRequired":true,"uniqueKey":"session.destination.oneOf.1.address","typeLabel":"string"},"tokenAddress":{"type":"string","description":"Destination token mint (base58). USDC only.","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","isRequired":true,"uniqueKey":"session.destination.oneOf.1.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","description":"Destination token symbol","example":"USDC","isRequired":true,"uniqueKey":"session.destination.oneOf.1.tokenSymbol","typeLabel":"string"},"amountUnits":{"type":"string","description":"Requested amount in token units","example":"10.00","uniqueKey":"session.destination.oneOf.1.amountUnits","typeLabel":"string"},"delivery":{"type":"object","properties":{"txHash":{"type":"string","description":"Delivery transaction signature","isRequired":true,"uniqueKey":"session.destination.oneOf.1.delivery.txHash","typeLabel":"string"},"receivedUnits":{"type":"string","description":"Amount actually received","isRequired":true,"uniqueKey":"session.destination.oneOf.1.delivery.receivedUnits","typeLabel":"string"}},"required":["txHash","receivedUnits"],"description":"Set once funds are delivered","uniqueKey":"session.destination.oneOf.1.delivery","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.destination.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","address","tokenAddress","tokenSymbol"],"properties":{"type":{"type":"string","enum":["tron"],"description":"Always \"tron\"","isRequired":true,"uniqueKey":"session.destination.oneOf.2.type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","description":"Destination address (base58)","example":"TTbM6AR9cEqXzqMaTqTTf4wC6h1bj6mY6N","isRequired":true,"uniqueKey":"session.destination.oneOf.2.address","typeLabel":"string"},"tokenAddress":{"type":"string","description":"Destination token address (base58). USDT only.","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","isRequired":true,"uniqueKey":"session.destination.oneOf.2.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","description":"Destination token symbol","example":"USDT","isRequired":true,"uniqueKey":"session.destination.oneOf.2.tokenSymbol","typeLabel":"string"},"amountUnits":{"type":"string","description":"Requested amount in token units","example":"10.00","uniqueKey":"session.destination.oneOf.2.amountUnits","typeLabel":"string"},"delivery":{"type":"object","properties":{"txHash":{"type":"string","description":"Delivery transaction ID","isRequired":true,"uniqueKey":"session.destination.oneOf.2.delivery.txHash","typeLabel":"string"},"receivedUnits":{"type":"string","description":"Amount actually received","isRequired":true,"uniqueKey":"session.destination.oneOf.2.delivery.receivedUnits","typeLabel":"string"}},"required":["txHash","receivedUnits"],"description":"Set once funds are delivered","uniqueKey":"session.destination.oneOf.2.delivery","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.destination.oneOf.2","typeLabel":"object"}],"isRequired":true,"uniqueKey":"session.destination","typeLabel":"object"},"display":{"type":"object","properties":{"title":{"type":"string","description":"Title shown in the payment modal","isRequired":true,"uniqueKey":"session.display.title","typeLabel":"string"},"verb":{"type":"string","description":"One-word verb for CTAs","example":"Deposit","isRequired":true,"uniqueKey":"session.display.verb","typeLabel":"string"},"themeCssUrl":{"type":"string","description":"Custom theme CSS URL","uniqueKey":"session.display.themeCssUrl","typeLabel":"string"},"themeMode":{"type":"string","enum":["system","light","dark"],"description":"Org-controlled theme mode. Defaults to system.","example":"system","uniqueKey":"session.display.themeMode","typeLabel":"enum\u003cstring>"}},"required":["title","verb"],"isRequired":true,"uniqueKey":"session.display","typeLabel":"object"},"paymentMethod":{"oneOf":[{"type":"object","required":["type","receiverAddress","createdAt"],"properties":{"type":{"type":"string","enum":["evm"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.type","typeLabel":"enum\u003cstring>"},"receiverAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Address that receives user's funds","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.receiverAddress","typeLabel":"string"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.createdAt","typeLabel":"number"},"source":{"type":"object","properties":{"chainId":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.source.chainId","typeLabel":"number"},"chainName":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.source.chainName","typeLabel":"string"},"tokenAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Checksummed Ethereum address","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.source.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.source.tokenSymbol","typeLabel":"string"},"sentUnits":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0.source.sentUnits","typeLabel":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Checksummed Ethereum address","uniqueKey":"session.paymentMethod.oneOf.0.source.address","typeLabel":"string"},"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","description":"Hex-encoded bytes","uniqueKey":"session.paymentMethod.oneOf.0.source.txHash","typeLabel":"string"}},"required":["chainId","chainName","tokenAddress","tokenSymbol","sentUnits"],"uniqueKey":"session.paymentMethod.oneOf.0.source","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.0","typeLabel":"object"},{"type":"object","required":["type","receiverAddress","createdAt"],"properties":{"type":{"type":"string","enum":["tron"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.type","typeLabel":"enum\u003cstring>"},"receiverAddress":{"type":"string","description":"Tron receiver address","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.receiverAddress","typeLabel":"string"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.createdAt","typeLabel":"number"},"source":{"type":"object","properties":{"chainId":{"type":"number","enum":[728126428],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.source.chainId","typeLabel":"enum\u003cnumber>"},"chainName":{"type":"string","enum":["tron"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.source.chainName","typeLabel":"enum\u003cstring>"},"tokenAddress":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.source.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.source.tokenSymbol","typeLabel":"string"},"sentUnits":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1.source.sentUnits","typeLabel":"string"},"address":{"type":"string","uniqueKey":"session.paymentMethod.oneOf.1.source.address","typeLabel":"string"},"txHash":{"type":"string","uniqueKey":"session.paymentMethod.oneOf.1.source.txHash","typeLabel":"string"}},"required":["chainId","chainName","tokenAddress","tokenSymbol","sentUnits"],"uniqueKey":"session.paymentMethod.oneOf.1.source","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.1","typeLabel":"object"},{"type":"object","required":["type","createdAt"],"properties":{"type":{"type":"string","enum":["solana"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.type","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.createdAt","typeLabel":"number"},"source":{"type":"object","properties":{"chainId":{"type":"number","enum":[501],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.source.chainId","typeLabel":"enum\u003cnumber>"},"chainName":{"type":"string","enum":["solana"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.source.chainName","typeLabel":"enum\u003cstring>"},"tokenAddress":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.source.tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.source.tokenSymbol","typeLabel":"string"},"sentUnits":{"type":"string","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2.source.sentUnits","typeLabel":"string"},"address":{"type":"string","uniqueKey":"session.paymentMethod.oneOf.2.source.address","typeLabel":"string"},"txHash":{"type":"string","uniqueKey":"session.paymentMethod.oneOf.2.source.txHash","typeLabel":"string"}},"required":["chainId","chainName","tokenAddress","tokenSymbol","sentUnits"],"uniqueKey":"session.paymentMethod.oneOf.2.source","typeLabel":"object"}},"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.2","typeLabel":"object"},{"type":"object","required":["type","createdAt"],"properties":{"type":{"type":"string","enum":["stripe"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.3.type","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.3.createdAt","typeLabel":"number"}},"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.3","typeLabel":"object"},{"type":"object","required":["type","createdAt"],"properties":{"type":{"type":"string","enum":["fiat"],"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.4.type","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"number","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.4.createdAt","typeLabel":"number"},"fiatMethod":{"type":"string","enum":["interac","ach","sepa","apple_pay","google_pay","jpyc","ars","breb"],"description":"Selected fiat method, when known","example":"interac","uniqueKey":"session.paymentMethod.oneOf.4.fiatMethod","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.4","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"session.paymentMethod.oneOf.5","typeLabel":"null"}],"isRequired":true,"uniqueKey":"session.paymentMethod","typeLabel":"object · object · object · object · object · null"},"createdAt":{"type":"number","description":"Unix timestamp (seconds)","example":1700000000,"isRequired":true,"uniqueKey":"session.createdAt","typeLabel":"number"},"expiresAt":{"type":"number","description":"Unix timestamp (seconds)","example":1700003600,"isRequired":true,"uniqueKey":"session.expiresAt","typeLabel":"number"},"metadata":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"session.metadata.oneOf.0.additionalProperties","typeLabel":"string"},"description":"Key-value metadata set at creation time. For fiat sessions, set `email` to start at email OTP, or `phone` as an E.164 phone hint for Apple Pay.","example":{"email":"account@daimo.com","phone":"+14155552671","orderId":"123"},"isRequired":true,"uniqueKey":"session.metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"session.metadata.oneOf.1.additionalProperties","typeLabel":"string"},"description":"Key-value metadata set at creation time. For fiat sessions, set `email` to start at email OTP, or `phone` as an E.164 phone hint for Apple Pay.","example":{"email":"account@daimo.com","phone":"+14155552671","orderId":"123"},"isRequired":true,"uniqueKey":"session.metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"session.metadata","typeLabel":"object | null"},"clientSecret":{"type":"string","description":"Per-session client secret","isRequired":true,"uniqueKey":"session.clientSecret","typeLabel":"string"}},"isRequired":true,"uniqueKey":"session","typeLabel":"object"}},"required":["session"],"uniqueKey":"","typeLabel":"object"},"example":{"session":{"sessionId":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4","status":"requires_payment_method","destination":{"type":"evm","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":8453,"chainName":"Base","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","tokenSymbol":"USDC","amountUnits":"10.00"},"display":{"title":"Deposit to Acme","verb":"Deposit"},"paymentMethod":null,"metadata":null,"clientSecret":"d7a8f3b2e1c94a6db8f0e2a7c3d5b9f1","createdAt":1700000000,"expiresAt":1700003600}},"examples":{"Example":{"title":"Example","value":{"session":{"sessionId":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4","status":"requires_payment_method","destination":{"type":"evm","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chainId":8453,"chainName":"Base","tokenAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","tokenSymbol":"USDC","amountUnits":"10.00"},"display":{"title":"Deposit to Acme","verb":"Deposit"},"paymentMethod":null,"metadata":null,"clientSecret":"d7a8f3b2e1c94a6db8f0e2a7c3d5b9f1","createdAt":1700000000,"expiresAt":1700003600}}}},"exampleType":"examples"}},"exampleType":"examples"},"95eb8836-6755-4eea-8748-4c16087ced13":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error category","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description","example":"invalid session create request","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Parameter that caused the error","example":"body","uniqueKey":"error.param","typeLabel":"string"}},"required":["type","code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"validation_error","code":"invalid_parameter","message":"invalid session create request","param":"body"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bcffec42-7624-4e40-bad7-d753c74127b9":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error category","example":"validation_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable description","example":"invalid session create request","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"type":"string","description":"Parameter that caused the error","example":"body","uniqueKey":"error.param","typeLabel":"string"}},"required":["type","code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"validation_error","code":"invalid_parameter","message":"invalid session create request","param":"body"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8c0b933c-b57a-4698-ba2a-ba375f61af04":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key passed as a Bearer token","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"b96ac1b4-d6b8-4971-a9c7-00c2fbf6d8d9":{"url":"https://api.daimo.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key passed as a Bearer token","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key passed as a Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"daimo","siteName":"Daimo","title":"Create session - Daimo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T21:20:37.076Z","originalFileLocation":"api-reference/create-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Daimo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create session - Daimo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Daimo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.daimo.com/api-reference/create-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://daimo.mintlify.site/_mintlify/api/og/v2?division=Sessions\u0026amp;title=Create+session\u0026amp;description=Creates+a+new+deposit+session.+Returns+the+session+object+including+a+client+secret+for+client-side+operations.\u0026amp;theme=c79f996493a64e0ed1e8e326\u0026amp;signature=46a060c75b10deb263c7b1b2793ea6c5a21bb5fa2981b0708b1f4f9ceedd830b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create session - Daimo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://daimo.mintlify.site/_mintlify/api/og/v2?division=Sessions\u0026amp;title=Create+session\u0026amp;description=Creates+a+new+deposit+session.+Returns+the+session+object+including+a+client+secret+for+client-side+operations.\u0026amp;theme=c79f996493a64e0ed1e8e326\u0026amp;signature=46a060c75b10deb263c7b1b2793ea6c5a21bb5fa2981b0708b1f4f9ceedd830b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/daimo/v0Gc6IuKr0Zv8Fs8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Daimo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#009110\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.daimo.com/api-reference/create-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.daimo.com/#organization\",\"name\":\"Daimo\",\"url\":\"https://docs.daimo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/daimo/9lH0w9xCPumaY8Il/logo.svg?fit=max\u0026auto=format\u0026n=9lH0w9xCPumaY8Il\u0026q=85\u0026s=64db2bb549081a11580068f5169bdf5a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.daimo.com#website\",\"name\":\"Daimo\",\"url\":\"https://docs.daimo.com\",\"publisher\":{\"@id\":\"https://docs.daimo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.daimo.com/api-reference/create-session#webpage\",\"url\":\"https://docs.daimo.com/api-reference/create-session\",\"name\":\"Create session\",\"description\":\"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\",\"dateModified\":\"2026-10-19T21:20:37.076Z\",\"isPartOf\":{\"@id\":\"https://docs.daimo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.daimo.com/api-reference/create-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.daimo.com/api-reference/create-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Daimo\",\"item\":\"https://docs.daimo.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create session\",\"item\":\"https://docs.daimo.com/api-reference/create-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.daimo.com/api-reference/create-session#apireference\",\"headline\":\"Create session\",\"name\":\"Create session\",\"description\":\"Creates a new deposit session. Returns the session object including a client secret for client-side operations.\",\"url\":\"https://docs.daimo.com/api-reference/create-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.daimo.com/api-reference/create-session#webpage\"},\"dateModified\":\"2026-10-19T21:20:37.076Z\",\"publisher\":{\"@id\":\"https://docs.daimo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.daimo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Daimo\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Daimo\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/create-session.md","siteName":"Daimo","nav":{"global":null,"tabs":[{"tab":"Guide","pages":[{"title":"Guide","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Overview","description":"Base URL, authentication, errors, and core types","href":"/api-reference/overview"}]},{"group":"Sessions","pages":[{"title":"Create session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sessions","href":"/api-reference/create-session"},{"title":"Retrieve session","description":"Retrieves a session by ID. With an API key, returns the full Session (including metadata and clientSecret). Without an API key, returns SessionPublicInfo only.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sessions/{sessionId}","href":"/api-reference/retrieve-session"},{"title":"Check session","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/sessions/{sessionId}/check","href":"/api-reference/check-session"},{"title":"Create payment method","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sessions/{sessionId}/paymentMethods","href":"/api-reference/create-payment-method"}]},{"group":"External Integrations","pages":[{"title":"Import Sumsub KYC","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sumsub/import","href":"/api-reference/import-sumsub-kyc"}]},{"group":"Webhooks","pages":[{"title":"Create webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks","href":"/api-reference/create-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks","href":"/api-reference/list-webhook-endpoints"},{"title":"Retrieve webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/{webhookId}","href":"/api-reference/retrieve-webhook-endpoint"},{"title":"Delete webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/{webhookId}","href":"/api-reference/delete-webhook-endpoint"},{"title":"Send test event","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/{webhookId}/test","href":"/api-reference/send-test-event"}]}]}]},"basePath":"","title":"Create session - Daimo","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}