{
"message": "The given data was invalid.",
"errors": {
"name": [
"The name field is required."
]
}
}
Customers
Create Customer
Creates a new customer (buyer or seller). If a customer with the same email/phone already exists
for this account, the existing record is updated and returned.
Gateway-linked customer type. When set, additional KYC fields become required.
CLEARJUNCTION requires id card fields; CURRENCYCLOUD also requires email and phone.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truust","colors":{"primary":"#073963","light":"#058ed8","dark":"#073963"},"logo":{"light":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","dark":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","href":"https://truust.io"},"favicon":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","navbar":{"links":[{"href":"https://truust.io","label":"Truust Website"},{"href":"https://truust.io/contact/","label":"Contact Us"}]},"footer":{"socials":{"website":"https://truust.io"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialpay","hasAudioNarration":false,"actualSubdomain":"socialpay","customDomains":["docs.truust.io"],"gitSource":{"type":"github","owner":"truust-io","repo":"docs.truust.io","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae89a23f8e61e223f91fd82","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":146},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Verifications","count":10},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Payins","count":7},{"language":"default","tag":"Bundles","count":6},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Wallets","count":5},{"language":"default","tag":"Platform","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"llms-txt-v2","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child code{white-space:nowrap}"}],"page":{"pagePath":"api-reference/create-customer","slug":"/api-reference/create-customer","pageMetadata":{"title":"Create Customer","openapi":"POST /customers","description":"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists\nfor this account, the existing record is updated and returned.\n\nEither `email` or `phone` (with `prefix`) is required.\n","href":"/api-reference/create-customer"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists\\nfor this account, the existing record is updated and returned.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Either \", _jsx(_components.code, {\n children: \"email\"\n }), \" or \", _jsx(_components.code, {\n children: \"phone\"\n }), \" (with \", _jsx(_components.code, {\n children: \"prefix\"\n }), \") is required.\"]\n })]\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 Customer","openapi":"POST /customers","description":"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists\nfor this account, the existing record is updated and returned.\n\nEither `email` or `phone` (with `prefix`) is required.\n","href":"/api-reference/create-customer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create customer","description":"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists\nfor this account, the existing record is updated and returned.\n\nEither `email` or `phone` (with `prefix`) is required.\n","operationId":"createCustomer","tags":["Customers"],"requestBody":"e3f0e924-acdf-485f-b028-a4550569dc9c","responses":{"200":"ec7c29d5-0c8c-40fc-b5d7-cb0b8d4d8428","422":"6fe3dd78-913d-4332-afe1-2af0b71fe279"},"method":"post","type":"path","servers":["0f42c800-8246-4ac3-9108-23b6b071ae36","82d02f21-f641-4af8-8110-3ba7289f1338"],"security":["ba798aec-ece0-4b40-af38-d7b7451a8091"],"path":"/customers","baseUrlOptions":["https://{subdomain}.truust.io/2.0","https://{subdomain}-sandbox.truust.io/2.0"],"title":"Create customer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","example":{"name":"John Doe","email":"john@example.com","prefix":"+34","phone":"612345678"},"properties":{"name":{"type":"string","maxLength":255,"example":"John Doe","uniqueKey":"name","typeLabel":"string"},"first_name":{"type":"string","maxLength":255,"example":"John","uniqueKey":"first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":255,"example":"Doe","uniqueKey":"last_name","typeLabel":"string"},"email":{"type":"string","format":"email","maxLength":255,"description":"Required if `phone` is not provided.","example":"john@example.com","uniqueKey":"email","typeLabel":"string\u003cemail>"},"prefix":{"type":"string","description":"Phone country prefix (e.g. `+34`). Required with `phone`.","example":"+34","uniqueKey":"prefix","typeLabel":"string"},"phone":{"type":"string","description":"Phone number without prefix. Required if `email` is not provided.","example":"612345678","uniqueKey":"phone","typeLabel":"string"},"locale":{"type":"string","description":"Customer's preferred locale.","example":"es","uniqueKey":"locale","typeLabel":"string"},"tag":{"type":"string","maxLength":100,"description":"Custom tag for grouping or filtering.","uniqueKey":"tag","typeLabel":"string"},"vat_id":{"type":"string","maxLength":255,"description":"Tax identification number.","uniqueKey":"vat_id","typeLabel":"string"},"type":{"type":"string","enum":["CLEARJUNCTION","CURRENCYCLOUD"],"description":"Gateway-linked customer type. When set, additional KYC fields become required.\n`CLEARJUNCTION` requires id card fields; `CURRENCYCLOUD` also requires email and phone.\n","uniqueKey":"type","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","additionalProperties":true,"description":"Arbitrary key-value metadata. For `CLEARJUNCTION` and `CURRENCYCLOUD` types,\npass KYC data under `metadata.kyc`.\n","properties":{"kyc":{"type":"object","description":"KYC identity data. Required for CLEARJUNCTION / CURRENCYCLOUD.","properties":{"date_birth":{"type":"string","format":"date","description":"Date of birth. Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.kyc.date_birth","typeLabel":"string\u003cdate>"},"type":{"type":"string","enum":["company","individual"],"description":"Entity type. Required for CURRENCYCLOUD.","uniqueKey":"metadata.kyc.type","typeLabel":"enum\u003cstring>"},"street_residence":{"type":"string","description":"Street address. Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.kyc.street_residence","typeLabel":"string"},"city_residence":{"type":"string","description":"City. Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.kyc.city_residence","typeLabel":"string"},"zip_residence":{"type":"string","description":"Postal code. Required for CLEARJUNCTION.","uniqueKey":"metadata.kyc.zip_residence","typeLabel":"string"},"country_residence":{"type":"string","description":"2-letter country code. Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.kyc.country_residence","typeLabel":"string"},"id_card_type":{"type":"string","description":"ID document type. Required for CLEARJUNCTION.","uniqueKey":"metadata.kyc.id_card_type","typeLabel":"string"},"id_card":{"type":"string","description":"ID document number. Required for CLEARJUNCTION.","uniqueKey":"metadata.kyc.id_card","typeLabel":"string"},"id_card_country":{"type":"string","description":"2-letter country code of the ID. Required for CLEARJUNCTION.","uniqueKey":"metadata.kyc.id_card_country","typeLabel":"string"}},"uniqueKey":"metadata.kyc","typeLabel":"object"}},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"John Doe","email":"john@example.com","prefix":"+34","phone":"612345678"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ec7c29d5-0c8c-40fc-b5d7-cb0b8d4d8428":{"description":"Customer created or updated","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"self":{"type":"string","example":"/2.0/customers/abc123","uniqueKey":"self","typeLabel":"string"},"uuid":{"type":"string","uniqueKey":"uuid","typeLabel":"string"},"type":{"oneOf":[{"type":"string","uniqueKey":"type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"type.oneOf.1","typeLabel":"null"}],"uniqueKey":"type","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"first_name":{"oneOf":[{"type":"string","uniqueKey":"first_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","uniqueKey":"last_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","format":"email","uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"prefix":{"oneOf":[{"type":"string","example":"+34","uniqueKey":"prefix.oneOf.0","typeLabel":"string"},{"type":"null","example":"+34","uniqueKey":"prefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"prefix","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","uniqueKey":"phone.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"phone.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone","typeLabel":"string | null"},"tag":{"oneOf":[{"type":"string","uniqueKey":"tag.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tag.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"connections":{"type":"object","description":"Hypermedia links to related resources.","additionalProperties":{"type":"string","uniqueKey":"connections.additionalProperties","typeLabel":"string"},"uniqueKey":"connections","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"self":"/2.0/customers/abc123","uuid":"\u003cstring>","type":"\u003cstring>","name":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","email":"jsmith@example.com","prefix":"+34","phone":"\u003cstring>","tag":"\u003cstring>","metadata":{},"created_at":"2023-11-07T05:31:56Z","connections":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"6fe3dd78-913d-4332-afe1-2af0b71fe279":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"name":["The name field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ba798aec-ece0-4b40-af38-d7b7451a8091":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0f42c800-8246-4ac3-9108-23b6b071ae36":{"url":"https://{subdomain}.truust.io/2.0","description":"Production","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}},"82d02f21-f641-4af8-8110-3ba7289f1338":{"url":"https://{subdomain}-sandbox.truust.io/2.0","description":"Sandbox","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your account's **Secret Key** as the Bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"socialpay","siteName":"Truust","title":"Create Customer - Truust","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T07:06:50.189Z","originalFileLocation":"api-reference/create-customer.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 customer (buyer or seller). If a customer with the same email/phone already exists for this account, the existing record is updated and returned. Either email or phone (with prefix) is required.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truust\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Customer - Truust\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists for this account, the existing record is updated and returned. Either email or phone (with prefix) is required.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truust\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truust.io/api-reference/create-customer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+Customer\u0026amp;description=Creates+a+new+customer+%28buyer+or+seller%29.+If+a+customer+with+the+same+email%2Fphone+already+exists%0Afor+this+account%2C+the+existing+record+is+updated+and+returned.%0A\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=c0b3f6569054d6b3e995f3f4bcab571153a75040890efe38e666a1c365c7f8f0\">\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 Customer - Truust\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists for this account, the existing record is updated and returned. Either email or phone (with prefix) is required.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Create+Customer\u0026amp;description=Creates+a+new+customer+%28buyer+or+seller%29.+If+a+customer+with+the+same+email%2Fphone+already+exists%0Afor+this+account%2C+the+existing+record+is+updated+and+returned.%0A\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=c0b3f6569054d6b3e995f3f4bcab571153a75040890efe38e666a1c365c7f8f0\">\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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truust\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#073963\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truust.io/api-reference/create-customer\">\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-customer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truust.io/#organization\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truust.io#website\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truust.io/api-reference/create-customer#webpage\",\"url\":\"https://docs.truust.io/api-reference/create-customer\",\"name\":\"Create Customer\",\"description\":\"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists for this account, the existing record is updated and returned. Either email or phone (with prefix) is required.\",\"dateModified\":\"2026-03-12T07:06:50.189Z\",\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truust.io/api-reference/create-customer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truust.io/api-reference/create-customer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.truust.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customers\",\"item\":\"https://docs.truust.io/api-reference/list-customers\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create Customer\",\"item\":\"https://docs.truust.io/api-reference/create-customer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truust.io/api-reference/create-customer#apireference\",\"headline\":\"Create Customer\",\"name\":\"Create Customer\",\"description\":\"Creates a new customer (buyer or seller). If a customer with the same email/phone already exists for this account, the existing record is updated and returned. Either email or phone (with prefix) is required.\",\"url\":\"https://docs.truust.io/api-reference/create-customer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truust.io/api-reference/create-customer#webpage\"},\"dateModified\":\"2026-03-12T07:06:50.189Z\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truust\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Truust\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/create-customer.md","siteName":"Truust","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"},{"group":"Account","pages":[{"title":"Get Current Account","openapi":"GET /accounts/me","href":"/api-reference/get-account"},{"title":"Update Account","openapi":"PUT /accounts/me","href":"/api-reference/update-account"},{"title":"Create Account","openapi":"POST /accounts","href":"/api-reference/create-account"},{"title":"Get Account Fees","openapi":"GET /accounts/fees/{currency}","href":"/api-reference/get-account-fees"},{"title":"Verify Account","openapi":"POST /accounts/verify","href":"/api-reference/verify-account"}]},{"group":"Customers","pages":[{"title":"List Customers","openapi":"GET /customers","description":"Returns a paginated list of customers associated with the authenticated account.","href":"/api-reference/list-customers"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/create-customer"},{"title":"Get Customer","openapi":"GET /customers/{uuid}","description":null,"href":"/api-reference/get-customer"},{"title":"Update Customer","openapi":"PUT /customers/{uuid}","href":"/api-reference/update-customer"},{"title":"List Customer Wallets","openapi":"GET /customers/{uuid}/wallets","href":"/api-reference/list-customer-wallets"},{"title":"List Customer Cards","openapi":"GET /customers/{uuid}/cards","href":"/api-reference/list-customer-cards"},{"title":"Add Card to Customer","openapi":"POST /customers/{uuid}/cards","href":"/api-reference/create-card"},{"title":"List Customer Bank Accounts","openapi":"GET /customers/{uuid}/bankaccounts","href":"/api-reference/list-customer-bank-accounts"},{"title":"List Customer Addresses","openapi":"GET /customers/{uuid}/addresses","href":"/api-reference/list-customer-addresses"},{"title":"Add Address to Customer","openapi":"POST /customers/{uuid}/addresses","href":"/api-reference/create-customer-address"},{"title":"Get Customer Address","openapi":"GET /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/get-customer-address"},{"title":"Update Customer Address","openapi":"PUT /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/update-customer-address"},{"title":"List Customer Subscriptions","openapi":"GET /customers/{uuid}/subscriptions","href":"/api-reference/list-customer-subscriptions"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/list-orders"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/create-order"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/get-order"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/update-order"},{"title":"Get Order Payin","openapi":"GET /orders/{id}/payin","href":"/api-reference/get-order-payin"},{"title":"Get Order Payout","openapi":"GET /orders/{id}/payout","href":"/api-reference/get-order-payout"},{"title":"Accept Order","openapi":"POST /orders/{id}/accept","href":"/api-reference/accept-order"},{"title":"Cancel Order","openapi":"POST /orders/{id}/cancel","href":"/api-reference/cancel-order"},{"title":"Validate Order","openapi":"POST /orders/{id}/validate","href":"/api-reference/validate-order"},{"title":"Send Order Receipt","openapi":"POST /orders/{id}/receipt","href":"/api-reference/send-order-receipt"},{"title":"Reimburse Order","openapi":"POST /orders/{id}/reimburse","href":"/api-reference/reimburse-order"}]},{"group":"Payins","pages":[{"title":"List Payins","openapi":"GET /payins","href":"/api-reference/list-payins"},{"title":"Create Payin","openapi":"POST /payins","href":"/api-reference/create-payin"},{"title":"Get Payin","openapi":"GET /payins/{id}","href":"/api-reference/get-payin"},{"title":"Sync Payin Status","openapi":"PUT /payins/{id}","href":"/api-reference/sync-payin"},{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","href":"/api-reference/refund-payin"},{"title":"Cancel Pre-Authorization","openapi":"POST /payins/{id}/cancelpreauth","href":"/api-reference/cancel-pre-auth"},{"title":"Request to Pay","openapi":"POST /payins/{id}/request","href":"/api-reference/request-to-pay"}]},{"group":"Payouts","pages":[{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/list-payouts"},{"title":"Create Payout","openapi":"POST /payouts","href":"/api-reference/create-payout"},{"title":"Get Payout","openapi":"GET /payouts/{id}","href":"/api-reference/get-payout"},{"title":"Sync Payout Status","openapi":"POST /payouts/{id}/update","href":"/api-reference/sync-payout"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/list-wallets"},{"title":"Create Wallet","openapi":"POST /wallets","href":"/api-reference/create-wallet"},{"title":"Get Wallet","openapi":"GET /wallets/{uuid}","href":"/api-reference/get-wallet"},{"title":"Update Wallet","openapi":"PUT /wallets/{uuid}","href":"/api-reference/update-wallet"},{"title":"List Wallet Transactions","openapi":"GET /wallets/{uuid}/transactions","href":"/api-reference/list-wallet-transactions"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","openapi":"POST /bankaccounts","href":"/api-reference/create-bank-account"},{"title":"Get Bank Account","openapi":"GET /bankaccounts/{uuid}","href":"/api-reference/get-bank-account"},{"title":"Get Bank Account Validation","openapi":"GET /bankaccounts/validation","href":"/api-reference/get-bank-account-validation"}]},{"group":"Cards","pages":[{"title":"Get Card","openapi":"GET /cards/{uuid}","href":"/api-reference/get-card"},{"title":"Delete Card","openapi":"DELETE /cards/{uuid}","href":"/api-reference/delete-card"}]},{"group":"Subscriptions","pages":[{"title":"List Subscriptions","openapi":"GET /subscriptions","href":"/api-reference/list-subscriptions"},{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscriptions/{id}","href":"/api-reference/get-subscription"},{"title":"Cancel Subscription","openapi":"PUT /subscriptions/{id}/cancel","href":"/api-reference/cancel-subscription"}]},{"group":"Verifications","pages":[{"title":"List Verifications","openapi":"GET /verifications","href":"/api-reference/list-verifications"},{"title":"Get Verification","openapi":"GET /verifications/{uuid}","href":"/api-reference/get-verification"},{"title":"Submit Verification (KYC)","openapi":"PUT /verifications/{uuid}","href":"/api-reference/submit-verification"},{"title":"Request Verification Review","openapi":"POST /verifications/{uuid}/request","href":"/api-reference/request-verification"},{"title":"Create KYC for a Customer","openapi":"POST /customers/{uuid}/verify","href":"/api-reference/create-customer-verification"},{"title":"Get KYC Verification for a Customer","openapi":"GET /customers/{uuid}/verification","href":"/api-reference/get-customer-verification"},{"title":"List Verification Documents","openapi":"GET /verifications/{uuid}/documents","href":"/api-reference/list-verification-documents"},{"title":"Upload Verification Document","openapi":"POST /verifications/{uuid}/documents","href":"/api-reference/upload-verification-document"},{"title":"Get Verification Document","openapi":"GET /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/get-verification-document"},{"title":"Update Verification Document","openapi":"PUT /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/update-verification-document"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundles","href":"/api-reference/list-bundles"},{"title":"Create Bundle","openapi":"POST /bundles","href":"/api-reference/create-bundle"},{"title":"List Expired Bundles","openapi":"GET /bundles/expired","href":"/api-reference/list-expired-bundles"},{"title":"Get Bundle","openapi":"GET /bundles/{bundle_id}","href":"/api-reference/get-bundle"},{"title":"Update Bundle","openapi":"PUT /bundles/{bundle_id}","href":"/api-reference/update-bundle"},{"title":"List Orders for a Bundle","openapi":"GET /bundles/{bundle_id}/orders","href":"/api-reference/list-bundle-orders"}]},{"group":"Refunds","pages":[{"title":"List Refunds","openapi":"GET /refunds","href":"/api-reference/list-refunds"},{"title":"Get Refund","openapi":"GET /refunds/{id}","href":"/api-reference/get-refund"}]}]}]}]},"basePath":"","title":"Create Customer - Truust","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}