Onramps the customer has successfully transacted on, with the timestamp of the most recent successful transaction for each. Empty if the customer has no prior successful onramp transactions.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Meld","colors":{"primary":"#000000","light":"#333333","dark":"#000000"},"logo":{"light":"https://mintcdn.com/meld-e276f676/9EVVQ1Ona28SP_qw/logo/light.svg?fit=max\u0026auto=format\u0026n=9EVVQ1Ona28SP_qw\u0026q=85\u0026s=6a498429bac268f91120055053a14593","dark":"https://mintcdn.com/meld-e276f676/9EVVQ1Ona28SP_qw/logo/dark.svg?fit=max\u0026auto=format\u0026n=9EVVQ1Ona28SP_qw\u0026q=85\u0026s=db79e8d4d4ddeb3ce23be15e159cc5b6"},"favicon":"https://mintcdn.com/meld-e276f676/hUvLlcIJC-ZfeJZm/favicon.svg?fit=max\u0026auto=format\u0026n=hUvLlcIJC-ZfeJZm\u0026q=85\u0026s=1d361599ebecc87def220cc278fbb12f","api":{"examples":{"defaults":"required","prefill":true}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://www.meld.io/coverage","label":"Coverage"},{"href":"mailto:support@meld.io","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/meldio"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"meld-e276f676","hasAudioNarration":false,"actualSubdomain":"meld-e276f676","customDomains":["docs.meld.io"],"gitSource":{"type":"github","owner":"meldeng","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad7b3faa5f82acf6a8cac34","collectionId":"ca2d4ce5-06ba-426e-825c-9569d8b8c355","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7b3faa5f82acf6a8cac34"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1a199f8179dd80879b5db","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":194},{"language":"default","tag":"Documentation","count":150},{"language":"default","tag":"Bank Linking","count":149},{"language":"default","tag":"Stablecoins \u0026 Digital Assets","count":52},{"language":"default","tag":"Partner Details","count":37},{"language":"default","tag":"Payments","count":30},{"language":"default","tag":"Transactions","count":27},{"language":"default","tag":"Service Providers","count":27},{"language":"default","tag":"Service Provider","count":27},{"language":"default","tag":"Crypto","count":22}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/customer/2025-03-04/customers/accounts-customers-create","slug":"/api-reference/customer/2025-03-04/customers/accounts-customers-create","pageMetadata":{"title":"Create a new customer or retrieve a customer by its external id","description":null,"deprecated":null,"version":null,"sidebarTitle":"Accounts customers create","openapi":"/openapi/customer-20250304.json post /accounts/customers","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-create","autogeneratedByOpenApi":true},"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 a new customer or retrieve a customer by its external id","description":null,"deprecated":null,"version":null,"sidebarTitle":"Accounts customers create","openapi":"/openapi/customer-20250304.json post /accounts/customers","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-create","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Customers"],"summary":"Create a new customer or retrieve a customer by its external id","operationId":"accounts-customers-create","requestBody":"5b0b1490-dfb7-428f-a4bf-0dc6cab69664","responses":{"200":"cbc4c691-63b7-4b46-a6d8-0027e3c91ad1","400":"24308f41-0c6d-4e2d-9ba3-69e24e39b154","401":"bb8eb4f3-ac06-4a86-8417-d64099252d03","403":"6d37ccd4-09c0-488e-b40f-637fe8328091","404":"362925ed-432c-41e3-be61-0fc9d56f03d2","409":"273fdc52-1d5d-43a8-8525-a1a41ac1c0b2","500":"00b0cbd5-5e34-4762-bedd-d4058bb2aadd"},"security":["d70c12db-8bf9-489f-a56c-397883f531a9"],"x-mint":{"href":"/api-reference/customer/2025-03-04/customers/accounts-customers-create"},"parameters":["94f629be-220f-495c-9457-b9d37c48d36a"],"method":"post","type":"path","servers":["d5fa3987-3b53-47ae-8722-e8f4265ac5e7","0e9865fe-f2b2-48c5-adf5-aae1060db8df"],"path":"/accounts/customers","baseUrlOptions":["https://api-sb.meld.io","https://api.meld.io"],"title":"Create a new customer or retrieve a customer by its external id","description":"","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.dateOfBirth":"\u003cstring>","body.email":"jsmith@example.com","body.externalId":"\u003cstring>","body.name.firstName":"\u003cstring>","body.name.lastName":"\u003cstring>","body.phone":"\u003cstring>"}]},"dependencies":{"parameters":{"94f629be-220f-495c-9457-b9d37c48d36a":{"name":"Meld-Version","in":"header","description":"Dated API version to use for this request, e.g. `2026-02-03`.","required":false,"schema":{"type":"string","example":"2025-03-04","isRequired":false,"description":"Dated API version to use for this request, e.g. `2026-02-03`.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"dateOfBirth":{"type":"string","description":"Customer's date of birth in ISO format (yyyy-MM-dd)","pattern":"^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$","uniqueKey":"dateOfBirth","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Customer's email","uniqueKey":"email","typeLabel":"string\u003cemail>"},"externalId":{"type":"string","description":"Customer's external id","uniqueKey":"externalId","typeLabel":"string"},"name":{"type":"object","description":"Customer's name","properties":{"firstName":{"type":"string","description":"First name","uniqueKey":"name.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name","uniqueKey":"name.lastName","typeLabel":"string"}},"uniqueKey":"name","typeLabel":"object"},"phone":{"type":"string","description":"Customer's phone number","uniqueKey":"phone","typeLabel":"string"},"type":{"type":"string","description":"Customer type","enum":["INDIVIDUAL","BUSINESS"],"uniqueKey":"type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"dateOfBirth":"\u003cstring>","email":"jsmith@example.com","externalId":"\u003cstring>","name":{"firstName":"\u003cstring>","lastName":"\u003cstring>"},"phone":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"cbc4c691-63b7-4b46-a6d8-0027e3c91ad1":{"description":"Customer is returned","content":{"*/*":{"schema":{"type":"object","properties":{"accountId":{"type":"string","description":"The unique identifier of your account with Meld. This id will be the same for all calls to Meld endpoints made from this account.","uniqueKey":"accountId","typeLabel":"string"},"addresses":{"type":"array","description":"List of customer addresses","items":{"type":"object","description":"Customer address","properties":{"addressDetails":{"type":"object","description":"Address details.","properties":{"city":{"type":"string","description":"City","uniqueKey":"addresses.items.[INDEX].addressDetails.city","typeLabel":"string"},"country":{"type":"string","description":"Country","uniqueKey":"addresses.items.[INDEX].addressDetails.country","typeLabel":"string"},"lineOne":{"type":"string","description":"Street address line one. May contain the entire street address if not broken up into lines one and two.","uniqueKey":"addresses.items.[INDEX].addressDetails.lineOne","typeLabel":"string"},"lineTwo":{"type":"string","description":"Street address line two.","uniqueKey":"addresses.items.[INDEX].addressDetails.lineTwo","typeLabel":"string"},"postalCode":{"type":"string","description":"Postal code. Depending on the country, this could be a zip code.","uniqueKey":"addresses.items.[INDEX].addressDetails.postalCode","typeLabel":"string"},"region":{"type":"string","description":"Region. Depending on the country, this could be a state or province.","uniqueKey":"addresses.items.[INDEX].addressDetails.region","typeLabel":"string"}},"uniqueKey":"addresses.items.[INDEX].addressDetails","typeLabel":"object"},"customerId":{"type":"string","description":"Customer id","uniqueKey":"addresses.items.[INDEX].customerId","typeLabel":"string"},"id":{"type":"string","description":"Unique identifier for this customer address","uniqueKey":"addresses.items.[INDEX].id","typeLabel":"string"},"status":{"type":"string","description":"Address status","enum":["ACTIVE","INACTIVE"],"uniqueKey":"addresses.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","description":"Address type","enum":["BILLING","SHIPPING","RESIDENCE"],"uniqueKey":"addresses.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"addresses.items.[INDEX]","typeLabel":"object"},"uniqueKey":"addresses","typeLabel":"object[]"},"dateOfBirth":{"type":"string","description":"Customer's date of birth in ISO format (yyyy-MM-dd)","uniqueKey":"dateOfBirth","typeLabel":"string"},"email":{"type":"string","description":"Customer email","uniqueKey":"email","typeLabel":"string"},"externalId":{"type":"string","description":"Externally assigned id for the customer","uniqueKey":"externalId","typeLabel":"string"},"id":{"type":"string","description":"Unique identifier for this customer","uniqueKey":"id","typeLabel":"string"},"key":{"type":"string","description":"When this customer is part of a paginated list, this key represents its position in the list.","uniqueKey":"key","typeLabel":"string"},"name":{"type":"object","description":"Customer name","properties":{"firstName":{"type":"string","description":"First name","uniqueKey":"name.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name","uniqueKey":"name.lastName","typeLabel":"string"}},"uniqueKey":"name","typeLabel":"object"},"phone":{"type":"string","description":"Customer phone","uniqueKey":"phone","typeLabel":"string"},"previouslyUsedOnramps":{"type":"array","description":"Onramps the customer has successfully transacted on, with the timestamp of the most recent successful transaction for each. Empty if the customer has no prior successful onramp transactions.","items":{"type":"object","properties":{"previouslyUsed":{"type":"string","format":"date-time","description":"Timestamp (UTC) of the most recent successful transaction on this onramp","uniqueKey":"previouslyUsedOnramps.items.[INDEX].previouslyUsed","typeLabel":"string\u003cdate-time>"},"serviceProvider":{"type":"string","description":"Onramp service provider the customer has successfully used before","enum":["ACROSS","AEROPAY","AKOYA","ALCHEMYPAY","APPLEPAY","AUTHORIZENET","BANXA","BILIRA","BINANCECONNECT","BINANCEPAY","BLOCKCHAINDOTCOM","BOOMFI","BRAINTREE","BRALE","BTCDIRECT","CASHAPP","CHECKOUT","CIRCLE","COINBASEPAY","COINFLOW","DUENETWORK","ELDORADO","FINICITY","FLASHNET","FONBNK","GUARDARIAN","HARBOUR","KOYWE","KRYPTONIM","MERCURYO","MESH","MESO","MOONPAY","MOOV","MX","NMI","NOAH","ONMETA","ONRAMPMONEY","PAYBIS","PAYPAL","PLAID","RAMP","REVOLUT","ROBINHOOD","ROUTERPROTOCOL","SALTEDGE","SALTEDGEPARTNERS","SARDINE","SHIFT4","SHOPIFY","SIMPLEX","SKRILLCRYPTO","SQUARE","STRIPE","SUMSUB","SWAPPED","TANGOCARD","TELLER","TOPPER","TRANSAK","TREMENDOUS","TRANSFI","UNLIMIT","UPHOLD","WYRE","XANPOOL","YELLOWCARD","YODLEE"],"uniqueKey":"previouslyUsedOnramps.items.[INDEX].serviceProvider","typeLabel":"enum\u003cstring>"}},"uniqueKey":"previouslyUsedOnramps.items.[INDEX]","typeLabel":"object"},"uniqueKey":"previouslyUsedOnramps","typeLabel":"object[]"},"serviceProviderCustomers":{"type":"array","description":"List of customers created with service providers.","items":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time","uniqueKey":"serviceProviderCustomers.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"customerId":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].customerId","typeLabel":"string"},"deletedAt":{"type":"string","format":"date-time","uniqueKey":"serviceProviderCustomers.items.[INDEX].deletedAt","typeLabel":"string\u003cdate-time>"},"id":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].id","typeLabel":"string"},"kyc":{"type":"object","properties":{"additionalInfo":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.additionalInfo.additionalProperties","typeLabel":"any"},"description":"Provider-specific data returned when KYC was shared (e.g. hosted onboarding URL)","uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.additionalInfo","typeLabel":"object"},"onboardingMethod":{"type":"object","description":"Onboarding method used to initiate the KYC share","properties":{"kycProvider":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.onboardingMethod.kycProvider","typeLabel":"string"},"onboardingType":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.onboardingMethod.onboardingType","typeLabel":"string"}},"uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.onboardingMethod","typeLabel":"object"},"status":{"type":"string","description":"Normalized KYC status","enum":["PENDING","APPROVED","REJECTED","EXPIRED","UNKNOWN"],"uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.status","typeLabel":"enum\u003cstring>"},"updatedAt":{"type":"string","format":"date-time","description":"When the status was last updated","uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"serviceProviderCustomers.items.[INDEX].kyc","typeLabel":"object"},"serviceProvider":{"type":"string","enum":["ACROSS","AEROPAY","AKOYA","ALCHEMYPAY","APPLEPAY","AUTHORIZENET","BANXA","BILIRA","BINANCECONNECT","BINANCEPAY","BLOCKCHAINDOTCOM","BOOMFI","BRAINTREE","BRALE","BTCDIRECT","CASHAPP","CHECKOUT","CIRCLE","COINBASEPAY","COINFLOW","DUENETWORK","ELDORADO","FINICITY","FLASHNET","FONBNK","GUARDARIAN","HARBOUR","KOYWE","KRYPTONIM","MERCURYO","MESH","MESO","MOONPAY","MOOV","MX","NMI","NOAH","ONMETA","ONRAMPMONEY","PAYBIS","PAYPAL","PLAID","RAMP","REVOLUT","ROBINHOOD","ROUTERPROTOCOL","SALTEDGE","SALTEDGEPARTNERS","SARDINE","SHIFT4","SHOPIFY","SIMPLEX","SKRILLCRYPTO","SQUARE","STRIPE","SUMSUB","SWAPPED","TANGOCARD","TELLER","TOPPER","TRANSAK","TREMENDOUS","TRANSFI","UNLIMIT","UPHOLD","WYRE","XANPOOL","YELLOWCARD","YODLEE"],"uniqueKey":"serviceProviderCustomers.items.[INDEX].serviceProvider","typeLabel":"enum\u003cstring>"},"serviceProviderAccessProfileId":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].serviceProviderAccessProfileId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","title":"FinicityCustomerDetails","required":["customerType","type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"serviceProviderCustomers.items.[INDEX].serviceProviderDetails.type","typeLabel":"string"},"customerType":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"serviceProviderCustomers.items.[INDEX].serviceProviderDetails.customerType","typeLabel":"string"}},"uniqueKey":"serviceProviderCustomers.items.[INDEX].serviceProviderDetails","typeLabel":"FinicityCustomerDetails · object"},"status":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].status","typeLabel":"string"},"wallets":{"type":"array","items":{"type":"string","uniqueKey":"serviceProviderCustomers.items.[INDEX].wallets.items.[INDEX]","typeLabel":"string"},"uniqueItems":true,"uniqueKey":"serviceProviderCustomers.items.[INDEX].wallets","typeLabel":"string[]"}},"uniqueKey":"serviceProviderCustomers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"serviceProviderCustomers","typeLabel":"object[]"},"status":{"type":"string","description":"Customer status","enum":["ACTIVE","INACTIVE"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"type":{"type":"string","description":"Customer type","enum":["INDIVIDUAL","BUSINESS"],"uniqueKey":"type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"accountId":"\u003cstring>","addresses":[{"addressDetails":{"city":"\u003cstring>","country":"\u003cstring>","lineOne":"\u003cstring>","lineTwo":"\u003cstring>","postalCode":"\u003cstring>","region":"\u003cstring>"},"customerId":"\u003cstring>","id":"\u003cstring>","status":"ACTIVE","type":"BILLING"}],"dateOfBirth":"\u003cstring>","email":"\u003cstring>","externalId":"\u003cstring>","id":"\u003cstring>","key":"\u003cstring>","name":{"firstName":"\u003cstring>","lastName":"\u003cstring>"},"phone":"\u003cstring>","previouslyUsedOnramps":[{"previouslyUsed":"2023-11-07T05:31:56Z","serviceProvider":"ACROSS"}],"serviceProviderCustomers":[{"createdAt":"2023-11-07T05:31:56Z","customerId":"\u003cstring>","deletedAt":"2023-11-07T05:31:56Z","id":"\u003cstring>","kyc":{"additionalInfo":{},"onboardingMethod":{"kycProvider":"\u003cstring>","onboardingType":"\u003cstring>"},"status":"PENDING","updatedAt":"2023-11-07T05:31:56Z"},"serviceProvider":"ACROSS","serviceProviderAccessProfileId":"\u003cstring>","serviceProviderDetails":{"type":"\u003cstring>","customerType":"\u003cstring>"},"status":"\u003cstring>","wallets":["\u003cstring>"]}],"status":"ACTIVE","type":"INDIVIDUAL"}}},"exampleType":"generated"}},"exampleType":"generated"},"24308f41-0c6d-4e2d-9ba3-69e24e39b154":{"description":"Bad Request : check request values and format\n\nRead errors[] and message for the field that failed, then correct it.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`BAD_REQUEST`","uniqueKey":"code","typeLabel":"string"},"errors":{"type":"array","description":"Any of:\n\n- `[email] must be a well-formed email address`\n- `[Meld-Version] is invalid`","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"string[]"},"message":{"type":"string","description":"Bad request","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"BAD_REQUEST","message":"Bad request","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00","errors":["[email] must be a well-formed email address"]},"examples":{"Example":{"title":"Example","value":{"code":"BAD_REQUEST","message":"Bad request","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00","errors":["[email] must be a well-formed email address"]}}},"exampleType":"examples"}},"exampleType":"examples"},"bb8eb4f3-ac06-4a86-8417-d64099252d03":{"description":"Invalid credentials\n\nCheck the API credentials being sent.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`UNAUTHORIZED`","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Access denied","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"UNAUTHORIZED","message":"Access denied","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"},"examples":{"Example":{"title":"Example","value":{"code":"UNAUTHORIZED","message":"Access denied","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"6d37ccd4-09c0-488e-b40f-637fe8328091":{"description":"Unauthenticated or authenticated with insufficient access\n\nCheck the account's permissions for this operation.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`FORBIDDEN`","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Access denied","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"FORBIDDEN","message":"Access denied","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"},"examples":{"Example":{"title":"Example","value":{"code":"FORBIDDEN","message":"Access denied","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"362925ed-432c-41e3-be61-0fc9d56f03d2":{"description":"Not found\n\nVerify the identifier in the request.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`NOT_FOUND`","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Resource not found","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"NOT_FOUND","message":"Resource not found","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"Resource not found","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"273fdc52-1d5d-43a8-8525-a1a41ac1c0b2":{"description":"Conflict\n\nResolve the conflicting state, then retry.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`CONFLICT`","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Conflict","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"CONFLICT","message":"Conflict","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"},"examples":{"Example":{"title":"Example","value":{"code":"CONFLICT","message":"Conflict","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"}}},"exampleType":"examples"}},"exampleType":"examples"},"00b0cbd5-5e34-4762-bedd-d4058bb2aadd":{"description":"Server Error. This applies to all 5xx errors, including but not limited to 500, 501, 502, 503, and 504 errors. You should treat all of these errors the same.\n\nAn internal Meld error. Contact Meld support with the requestId; a retry may not clear it.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"`UNEXPECTED_ERROR`","uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Unexpected error","uniqueKey":"message","typeLabel":"string"},"requestId":{"type":"string","description":"Quote this when asking Meld about a specific failure.","uniqueKey":"requestId","typeLabel":"string"},"serviceProviderDetails":{"type":"object","properties":{"code":{"type":"string","description":"The provider's own error code, when it sent one.","uniqueKey":"serviceProviderDetails.code","typeLabel":"string"},"message":{"type":"string","description":"The provider's own message.","uniqueKey":"serviceProviderDetails.message","typeLabel":"string"}},"example":{"code":"5034","message":"Digital currency and blockchain combination is restricted for customer's country"},"description":"The provider's own error detail, when the failure came from a service provider. Usually `code` and `message`; a few providers pass their own body through, so other keys can appear.","additionalProperties":{"oneOf":[{}],"uniqueKey":"serviceProviderDetails.additionalProperties","typeLabel":"any"},"uniqueKey":"serviceProviderDetails","typeLabel":"object"},"timestamp":{"type":"string","format":"date-time","description":"When the failure occurred. ISO 8601, UTC (`YYYY-MM-DDThh:mm:ss.sss+00:00`).","example":"2026-08-14T09:41:22.482+00:00","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"UNEXPECTED_ERROR","message":"Unexpected error","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"},"examples":{"Example":{"title":"Example","value":{"code":"UNEXPECTED_ERROR","message":"Unexpected error","requestId":"01JB2K7C9XQZ4M8N2P5R6T3V","timestamp":"2026-08-14T09:41:22.482+00:00"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d70c12db-8bf9-489f-a56c-397883f531a9":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","x-default":"BASIC \u003cMeld API Key>","scopes":[]}}},"servers":{"d5fa3987-3b53-47ae-8722-e8f4265ac5e7":{"url":"https://api-sb.meld.io","description":"Meld API sandbox"},"0e9865fe-f2b2-48c5-adf5-aae1060db8df":{"url":"https://api.meld.io","description":"Meld API production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","x-default":"BASIC \u003cMeld API Key>","scopes":[]},"schema":{"title":"Authorization","type":"string","isRequired":true,"default":"BASIC \u003cMeld API Key>","typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/customer-20250304.json"},"subdomain":"meld-e276f676","siteName":"Meld","title":"Create a new customer or retrieve a customer by its external id - Meld","navMaps":{"firstHrefInVersion":{"2026-02-03":{"href":"/api-reference/customer/customers/accounts-customers-search","matchLevel":2},"2025-03-04":{"href":"/api-reference/customer/2025-03-04/customers/accounts-customers-create","matchLevel":0},"2023-12-19":{"href":"/api-reference/customer/2023-12-19/customers/accounts-customers-create","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T07:18:05.575Z","originalFileLocation":"api-reference/customer/2025-03-04/customers/accounts-customers-create.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=\"light\"}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=\"application-name\" content=\"Meld\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_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/meld-e276f676/VTnI9uBWWNTnirMq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new customer or retrieve a customer by its external id - Meld\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Meld\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://meld-e276f676.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+a+new+customer+or+retrieve+a+customer+by+its+external+id\u0026amp;theme=28c66332baab02857e320658\u0026amp;signature=da15be077c846e8ec9855b6d2039067253f9bb96d937accde336b81551324349\">\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 a new customer or retrieve a customer by its external id - Meld\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://meld-e276f676.mintlify.app/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+a+new+customer+or+retrieve+a+customer+by+its+external+id\u0026amp;theme=28c66332baab02857e320658\u0026amp;signature=da15be077c846e8ec9855b6d2039067253f9bb96d937accde336b81551324349\">\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/meld-e276f676/VTnI9uBWWNTnirMq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Meld\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/customer/2025-03-04/customers/accounts-customers-create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.meld.io/#organization\",\"name\":\"Meld\",\"url\":\"https://docs.meld.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/meld-e276f676/9EVVQ1Ona28SP_qw/logo/light.svg?fit=max\u0026auto=format\u0026n=9EVVQ1Ona28SP_qw\u0026q=85\u0026s=6a498429bac268f91120055053a14593\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.meld.io#website\",\"name\":\"Meld\",\"url\":\"https://docs.meld.io\",\"publisher\":{\"@id\":\"https://docs.meld.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create#webpage\",\"url\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create\",\"name\":\"Create a new customer or retrieve a customer by its external id\",\"dateModified\":\"2026-10-28T07:18:05.575Z\",\"isPartOf\":{\"@id\":\"https://docs.meld.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customer\",\"item\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customers\",\"item\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-search\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a new customer or retrieve a customer by its external id\",\"item\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create#apireference\",\"headline\":\"Create a new customer or retrieve a customer by its external id\",\"name\":\"Create a new customer or retrieve a customer by its external id\",\"url\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.meld.io/api-reference/customer/2025-03-04/customers/accounts-customers-create#webpage\"},\"dateModified\":\"2026-10-28T07:18:05.575Z\",\"publisher\":{\"@id\":\"https://docs.meld.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.meld.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Meld\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Meld","nav":{"global":null,"versions":[{"version":"2026-02-03","default":true,"tag":"Latest","pages":[{"title":"2026-02-03","href":"/api-reference/customer/customers/accounts-customers-search"}]},{"version":"2025-03-04","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/welcome/overview"}]},{"tab":"API Reference","groups":[{"group":"Crypto","pages":[{"group":"Retail Ramp","pages":[{"title":"Create a crypto quote","deprecated":null,"version":null,"sidebarTitle":"Crypto quote get","openapi":"/openapi/crypto-20250304.json post /payments/crypto/quote","href":"/api-reference/crypto/2025-03-04/retail-ramp/crypto-quote-get"},{"title":"Create a crypto widget","deprecated":null,"version":null,"sidebarTitle":"Crypto session widget create","openapi":"/openapi/crypto-20250304.json post /crypto/session/widget","href":"/api-reference/crypto/2025-03-04/retail-ramp/crypto-session-widget-create"},{"title":"Get transaction by id","deprecated":null,"version":null,"sidebarTitle":"Payments transactions get","openapi":"/openapi/crypto-20250304.json get /payments/transactions/{id}","href":"/api-reference/crypto/2025-03-04/retail-ramp/payments-transactions-get"},{"title":"Search transactions","deprecated":null,"version":null,"sidebarTitle":"Payments transactions search","openapi":"/openapi/crypto-20250304.json get /payments/transactions","href":"/api-reference/crypto/2025-03-04/retail-ramp/payments-transactions-search"},{"title":"Fetch a transaction from the provider (for offramp use)","deprecated":null,"version":null,"sidebarTitle":"Payments transactions sessions get","openapi":"/openapi/crypto-20250304.json get /payments/transactions/sessions/{sessionId}","href":"/api-reference/crypto/2025-03-04/retail-ramp/payments-transactions-sessions-get"}]},{"group":"Headless","pages":[{"title":"Create a headless offramp order","deprecated":null,"version":null,"sidebarTitle":"Crypto order headless offramp create","openapi":"/openapi/crypto-20250304.json post /crypto/order/headless/offramp","href":"/api-reference/crypto/2025-03-04/headless/crypto-order-headless-offramp-create"},{"title":"Create or retrieve standing virtual-account onramp deposit instructions","deprecated":null,"version":null,"sidebarTitle":"Payments virtual account deposit instructions create","openapi":"/openapi/crypto-20250304.json post /payments/virtual-account/deposit-instructions","href":"/api-reference/crypto/2025-03-04/headless/payments-virtual-account-deposit-instructions-create"}]}]},{"group":"Bank Linking","pages":[{"group":"Connect","pages":[{"title":"Create a connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connect create","openapi":"/openapi/banklinking-20250304.json post /bank-linking/connect/start","href":"/api-reference/bank-linking/2025-03-04/connect/bank-linking-connect-create"},{"title":"Repair a connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connect repair","openapi":"/openapi/banklinking-20250304.json post /bank-linking/connect/repair","href":"/api-reference/bank-linking/2025-03-04/connect/bank-linking-connect-repair"}]},{"group":"Connections","pages":[{"title":"Get an institution connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connections get","openapi":"/openapi/banklinking-20250304.json get /bank-linking/connections/{connectionId}","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connections-get"},{"title":"Delete an institution connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connections delete","openapi":"/openapi/banklinking-20250304.json delete /bank-linking/connections/{connectionId}","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connections-delete"},{"title":"Search institution connections","deprecated":null,"version":null,"sidebarTitle":"Bank linking connections search","openapi":"/openapi/banklinking-20250304.json get /bank-linking/connections","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connections-search"},{"title":"Update a connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connection update","openapi":"/openapi/banklinking-20250304.json post /bank-linking/connections/{connectionId}/update","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connection-update"},{"title":"Refresh accounts belonging to a connection","deprecated":null,"version":null,"sidebarTitle":"Bank linking connections refresh","openapi":"/openapi/banklinking-20250304.json post /bank-linking/connections/{connectionId}/refresh","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connections-refresh"},{"title":"Import existing connections with a service provider","deprecated":null,"version":null,"sidebarTitle":"Bank linking connections import","openapi":"/openapi/banklinking-20250304.json post /bank-linking/connections/import","href":"/api-reference/bank-linking/2025-03-04/connections/bank-linking-connections-import"}]},{"group":"Accounts","pages":[{"title":"Get a financial account","deprecated":null,"version":null,"sidebarTitle":"Bank linking accounts get","openapi":"/openapi/banklinking-20250304.json get /bank-linking/accounts/{financialAccountId}","href":"/api-reference/bank-linking/2025-03-04/accounts/bank-linking-accounts-get"},{"title":"Search financial accounts","deprecated":null,"version":null,"sidebarTitle":"Bank linking accounts search","openapi":"/openapi/banklinking-20250304.json get /bank-linking/accounts","href":"/api-reference/bank-linking/2025-03-04/accounts/bank-linking-accounts-search"},{"title":"Create processor token","deprecated":null,"version":null,"sidebarTitle":"Bank linking accounts create processor token","openapi":"/openapi/banklinking-20250304.json post /bank-linking/accounts/{financialAccountId}/processors/create-token","href":"/api-reference/bank-linking/2025-03-04/accounts/bank-linking-accounts-create-processor-token"}]},{"group":"Transactions","pages":[{"title":"Get a financial account transaction","deprecated":null,"version":null,"sidebarTitle":"Bank linking transactions get","openapi":"/openapi/banklinking-20250304.json get /bank-linking/transactions/{transactionId}","href":"/api-reference/bank-linking/2025-03-04/transactions/bank-linking-transactions-get"},{"title":"Search financial account transactions","deprecated":null,"version":null,"sidebarTitle":"Bank linking transactions search","openapi":"/openapi/banklinking-20250304.json get /bank-linking/transactions","href":"/api-reference/bank-linking/2025-03-04/transactions/bank-linking-transactions-search"}]},{"group":"Investments","pages":[{"title":"Get a financial account investment holding","deprecated":null,"version":null,"sidebarTitle":"Bank linking investment holdings get","openapi":"/openapi/banklinking-20250304.json get /bank-linking/investments/holdings/{investmentHoldingId}","href":"/api-reference/bank-linking/2025-03-04/investments/bank-linking-investment-holdings-get"},{"title":"Search financial account investment holdings","deprecated":null,"version":null,"sidebarTitle":"Bank linking investment holdings search","openapi":"/openapi/banklinking-20250304.json get /bank-linking/investments/holdings","href":"/api-reference/bank-linking/2025-03-04/investments/bank-linking-investment-holdings-search"},{"title":"Get a financial account investment transaction","deprecated":null,"version":null,"sidebarTitle":"Bank linking investment transactions get","openapi":"/openapi/banklinking-20250304.json get /bank-linking/investments/transactions/{investmentTransactionId}","href":"/api-reference/bank-linking/2025-03-04/investments/bank-linking-investment-transactions-get"},{"title":"Search financial account investment transactions","deprecated":null,"version":null,"sidebarTitle":"Bank linking investment transactions search","openapi":"/openapi/banklinking-20250304.json get /bank-linking/investments/transactions","href":"/api-reference/bank-linking/2025-03-04/investments/bank-linking-investment-transactions-search"}]},{"group":"Institutions","pages":[{"title":"Get institution","deprecated":null,"version":null,"sidebarTitle":"Bank linking institutions get","openapi":"/openapi/banklinking-20250304.json get /institutions/{institutionId}","href":"/api-reference/bank-linking/2025-03-04/institutions/bank-linking-institutions-get"},{"title":"Search institutions","deprecated":null,"version":null,"sidebarTitle":"Bank linking institutions search","openapi":"/openapi/banklinking-20250304.json get /institutions","href":"/api-reference/bank-linking/2025-03-04/institutions/bank-linking-institutions-search"}]}]},{"group":"Payments","pages":[{"group":"Transactions","pages":[{"title":"Create a Meld payment token","deprecated":null,"version":null,"sidebarTitle":"Payment token post","openapi":"/openapi/payments-20250304.json post /payments/tokens","href":"/api-reference/payments/2025-03-04/transactions/payment-token-post"},{"title":"Search transactions","deprecated":null,"version":null,"sidebarTitle":"Payments transactions search","openapi":"/openapi/payments-20250304.json get /payments/transactions","href":"/api-reference/payments/2025-03-04/transactions/payments-transactions-search"},{"title":"Create a payment transaction","deprecated":null,"version":null,"sidebarTitle":"Payments transactions create","openapi":"/openapi/payments-20250304.json post /payments/transactions","href":"/api-reference/payments/2025-03-04/transactions/payments-transactions-create"},{"title":"Capture a payment transaction","deprecated":null,"version":null,"sidebarTitle":"Payments transactions capture","openapi":"/openapi/payments-20250304.json post /payments/transactions/{id}/capture","href":"/api-reference/payments/2025-03-04/transactions/payments-transactions-capture"},{"title":"Get transaction by id","deprecated":null,"version":null,"sidebarTitle":"Payments transactions get","openapi":"/openapi/payments-20250304.json get /payments/transactions/{id}","href":"/api-reference/payments/2025-03-04/transactions/payments-transactions-get"},{"title":"Refund a payment transaction","deprecated":null,"version":null,"sidebarTitle":"Payments transactions refund","openapi":"/openapi/payments-20250304.json post /payments/transactions/{id}/refund","href":"/api-reference/payments/2025-03-04/transactions/payments-transactions-refund"},{"title":"Create a payout transaction","deprecated":null,"version":null,"sidebarTitle":"Payouts transactions create","openapi":"/openapi/payments-20250304.json post /payments/transactions/payout","href":"/api-reference/payments/2025-03-04/transactions/payouts-transactions-create"}]},{"group":"External Transactions","pages":[{"title":"Import an external payment transaction","deprecated":null,"version":null,"sidebarTitle":"Payments external transactions import","openapi":"/openapi/payments-20250304.json post /payments/external/import","href":"/api-reference/payments/2025-03-04/external-transactions/payments-external-transactions-import"},{"title":"Refund an external payment transaction","deprecated":null,"version":null,"sidebarTitle":"Payments external transactions refund","openapi":"/openapi/payments-20250304.json post /payments/external/refund","href":"/api-reference/payments/2025-03-04/external-transactions/payments-external-transactions-refund"}]},{"group":"Risk","pages":[{"title":"Create a risk analysis","deprecated":null,"version":null,"sidebarTitle":"Payments transactions risk analysis","openapi":"/openapi/payments-20250304.json post /payments/risk-analysis","href":"/api-reference/payments/2025-03-04/risk/payments-transactions-risk-analysis"}]}]},{"group":"Customer","pages":[{"group":"Customers","pages":[{"title":"Search customers","description":"Returns a list of customers that match the query parameters. The customers are sorted by external id.","deprecated":null,"version":null,"sidebarTitle":"Accounts customers search","openapi":"/openapi/customer-20250304.json get /accounts/customers","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-search"},{"title":"Create a new customer or retrieve a customer by its external id","deprecated":null,"version":null,"sidebarTitle":"Accounts customers create","openapi":"/openapi/customer-20250304.json post /accounts/customers","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-create"},{"title":"Delete a customer","description":"Use this endpoint to delete a customer with Meld and/or with any of the service providers it is linked to. This endpoint should only be used for customers using the Bank-Linking stack, as it is not yet compatible with the Payments or Crypto stack. If a customer is deleted that is linked to a Payments or Crypto service provider customer, it will still be deleted with Meld, but not with the provider.\n\n***Note:*** For customers using the Bank-Linking stack, this will delete all of the customer's connections and financial accounts as well.","deprecated":null,"version":null,"sidebarTitle":"Accounts customers delete","openapi":"/openapi/customer-20250304.json delete /accounts/customers/{customerId}","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-delete"},{"title":"Update a customer","deprecated":null,"version":null,"sidebarTitle":"Accounts customers update","openapi":"/openapi/customer-20250304.json patch /accounts/customers/{customerId}","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-update"},{"title":"Add an address to a customer","deprecated":null,"version":null,"sidebarTitle":"Accounts customers addresses create","openapi":"/openapi/customer-20250304.json post /accounts/customers/{customerId}/addresses","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-addresses-create"},{"title":"Initiate customer KYC","deprecated":null,"version":null,"sidebarTitle":"Accounts customers kyc initiate","openapi":"/openapi/customer-20250304.json post /accounts/customers/{customerId}/kyc/initiate","href":"/api-reference/customer/2025-03-04/customers/accounts-customers-kyc-initiate"}]}]},{"group":"Service Providers","pages":[{"group":"Service Provider","pages":[{"title":"Search service providers","deprecated":true,"version":null,"sidebarTitle":"Service providers search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-search"},{"title":"Search countries","deprecated":true,"version":null,"sidebarTitle":"Service providers properties country search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/properties/countries","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-properties-country-search"},{"title":"Search crypto currencies","deprecated":true,"version":null,"sidebarTitle":"Service providers properties crypto currency search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/properties/crypto-currencies","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-properties-crypto-currency-search"},{"title":"Search defaults by country","deprecated":true,"version":null,"sidebarTitle":"Service providers properties defaults by country search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/properties/defaults/by-country","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-properties-defaults-by-country-search"},{"title":"Search fiat currencies","deprecated":true,"version":null,"sidebarTitle":"Service providers properties fiat currency search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/properties/fiat-currencies","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-properties-fiat-currency-search"},{"title":"Search payment methods","deprecated":true,"version":null,"sidebarTitle":"Service providers properties payment method search","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/properties/payment-methods","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-properties-payment-method-search"},{"title":"Get crypto sell limits for crypto currencies","deprecated":true,"version":null,"sidebarTitle":"Service providers limits crypto currency sells get","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/limits/crypto-currency-sells","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-limits-crypto-currency-sells-get"},{"title":"Get crypto purchase limits for fiat currencies","deprecated":true,"version":null,"sidebarTitle":"Service providers limits fiat currency purchase get","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/limits/fiat-currency-purchases","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-limits-fiat-currency-purchase-get"},{"title":"Get KYC levels for fiat currencies","deprecated":true,"version":null,"sidebarTitle":"Service providers limits kyc fiat level get","openapi":"/openapi/serviceproviders-20250304.json get /service-providers/limits/kyc-fiat-levels","href":"/api-reference/service-providers/2025-03-04/service-provider/service-providers-limits-kyc-fiat-level-get"}]}]},{"group":"Webhooks","pages":[{"group":"Profile","pages":[{"title":"Search webhook profiles","deprecated":null,"version":null,"sidebarTitle":"Webhooks profiles search","openapi":"/openapi/webhooks-20250304.json get /notifications/webhooks","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-profiles-search"},{"title":"Create a new webhook profile","deprecated":null,"version":null,"sidebarTitle":"Webhooks profiles create","openapi":"/openapi/webhooks-20250304.json post /notifications/webhooks","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-profiles-create"},{"title":"Get all webhook event types that can be sent","deprecated":null,"version":null,"sidebarTitle":"Webhooks events get","openapi":"/openapi/webhooks-20250304.json get /notifications/webhooks/event-types","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-events-get"},{"title":"Get an existing webhook profile","deprecated":null,"version":null,"sidebarTitle":"Webhooks profiles get","openapi":"/openapi/webhooks-20250304.json get /notifications/webhooks/{webhookProfileId}","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-profiles-get"},{"title":"Update an existing webhook profile","deprecated":null,"version":null,"sidebarTitle":"Webhooks profiles update","openapi":"/openapi/webhooks-20250304.json patch /notifications/webhooks/{webhookProfileId}","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-profiles-update"},{"title":"Test an existing webhook profile","deprecated":null,"version":null,"sidebarTitle":"Webhooks profiles test","openapi":"/openapi/webhooks-20250304.json post /notifications/webhooks/{webhookProfileId}/test","href":"/api-reference/webhooks/2025-03-04/profile/webhooks-profiles-test"}]}]},{"group":"Beta","pages":[{"group":"Activity Log","pages":[{"title":"Search activity log","deprecated":null,"version":null,"sidebarTitle":"Activity log search","openapi":"/openapi/beta-20250304.json get /activity-log","href":"/api-reference/beta/2025-03-04/activity-log/activity-log-search"},{"title":"Gets details for activities","deprecated":null,"version":null,"sidebarTitle":"Activity log details get","openapi":"/openapi/beta-20250304.json get /activity-log/details","href":"/api-reference/beta/2025-03-04/activity-log/activity-log-details-get"}]}]}]}]},{"version":"2023-12-19","pages":[{"title":"2023-12-19","href":"/api-reference/customer/2023-12-19/customers/accounts-customers-create"}]}]},"title":"Create a new customer or retrieve a customer by its external id - Meld","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}