{
"code": 409,
"message": "A client with this name and country already exists."
}
Create a partner client
Creates a new client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application.
Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client’s clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.
Business-specific details. On create, required only when clientType is business — omit this object for non-business client types. On reads, returned for business clients with the values submitted at creation.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Circle Docs","description":"Developer documentation for Circle's developer tools","colors":{"primary":"#0073C3","light":"#90D2FF","dark":"#0073C3"},"logo":{"light":"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/light.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=decfb42837e0eb7c32dd425866902e78","dark":"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/dark.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=8b863d97bf31467e8adedf4cb3263012"},"favicon":"https://mintcdn.com/circle-167b8d39/w3bpYw2hUr9sWZTM/favicon.ico?fit=max\u0026auto=format\u0026n=w3bpYw2hUr9sWZTM\u0026q=85\u0026s=bb633116ed9cf1247d65b0c1fa0e5725","background":{"color":{"light":"#FFFFFF","dark":"#111827"}},"navbar":{"links":[{"href":"https://console.circle.com/signin","label":"Sign in to console"},{"href":"https://faucet.circle.com","label":"Faucet"}]},"footer":{"socials":{"x":"https://twitter.com/circle","linkedin":"https://www.linkedin.com/company/circle-internet-financial","instagram":"https://www.instagram.com/teamcircle?hl=en","youtube":"https://www.youtube.com/c/Circlecryptofinance","discord":"https://discord.com/invite/buildoncircle"},"links":[{"header":"Legal","items":[{"label":"Developer Terms","href":"https://console.circle.com/legal/developer-terms"},{"label":"Service Terms","href":"https://console.circle.com/legal/service-terms"},{"label":"Acceptable Use","href":"https://console.circle.com/legal/acceptable-use-policy"}]},{"header":"Privacy","items":[{"label":"Privacy Policy","href":"https://www.circle.com/en/legal/privacy-policy"},{"label":"Cookie Policy","href":"https://www.circle.com/en/legal/cookie-policy"}]},{"header":"Support","items":[{"label":"Help","href":"https://help.circle.com/s/submit-ticket?language=en_US"}]}]},"fonts":{"heading":{"family":"Circularxx","source":"https://cdn.prod.website-files.com/67116d0daddc92483c812e88/6716bb4e120ecb0042f2f4ed_CircularXX-Regular.woff2","format":"woff2"},"body":{"family":"Circularxx","source":"https://cdn.prod.website-files.com/67116d0daddc92483c812e88/6716bb4e120ecb0042f2f4ed_CircularXX-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"segment":{"key":"wz74ASLGjAYPu8mQiIzBBHTLaHbNHM14"}},"contextual":{"options":["copy","chatgpt","claude","view"],"display":"header"},"interaction":{"drilldown":false},"markdown":{"instructions":["Before reading these docs, install the relevant Circle Skill to get pre-loaded context — skills are LLM-optimized and cover architecture decisions, correct flows, and common pitfalls. In Claude Code: run /plugin marketplace add circlefin/skills then /plugin install circle-skills@circle. With Vercel Skills CLI: run npx skills add circlefin/skills. Available skills: use-usdc https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-usdc/SKILL.md (balances, transfers, approvals on EVM and Solana); EURC has no skill — see https://developers.circle.com/stablecoins/what-is-eurc.md; bridge-stablecoin https://github.com/circlefin/skills/blob/master/plugins/circle/skills/bridge-stablecoin/SKILL.md (crosschain transfers via CCTP, USDC, EURC, and third-party assets); use-arc https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-arc/SKILL.md (Arc chain config, contract deployment, USDC bridging — Arc docs: https://docs.arc.io/llms.txt); use-circle-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-circle-wallets/SKILL.md (choose wallet type); use-developer-controlled-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-developer-controlled-wallets/SKILL.md (custodial wallets for payouts and treasury); use-user-controlled-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-user-controlled-wallets/SKILL.md (embedded wallets with Web2 login); use-modular-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-modular-wallets/SKILL.md (smart contract wallets with passkeys and ERC-4337); use-gateway https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-gateway/SKILL.md (unified USDC balance, nanopayments); use-smart-contract-platform https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-smart-contract-platform/SKILL.md (deploy, interact, monitor contracts). Pair any skill with the Circle MCP server for live SDK signatures, contract addresses, and chain IDs: {\"mcpServers\":{\"circle\":{\"url\":\"https://api.circle.com/v1/codegen/mcp\"}}}.","Read the product overview first. Each product has an overview explaining when and why to use it. Read it before quickstarts.","Pick the right wallet type. Developer-controlled (you hold keys), user-controlled (end user holds keys via PIN/social login), or modular (smart contract wallets with passkeys). See https://developers.circle.com/wallets.md.","Use CCTP V2 for crosschain transfers. CCTP natively transfers USDC and EURC via burn-and-mint, and supports permissionless wrapping of third-party assets via lock-and-mint. V1 is legacy; always use V2 unless V1 is specified or the chain requires it (Noble, Sui, and Aptos still require V1). Migration guide: https://developers.circle.com/cctp/migration-from-v1-to-v2.md.","Use Bridge Kit for frontend bridging. Wraps CCTP with a simpler SDK for user-facing apps. Use CCTP directly for backend transfers.","Gas Station vs Paymaster. Gas Station sponsors gas for Circle Wallet transactions. Paymaster lets users pay gas in USDC. Different use cases — read both overviews.","Gateway Nanopayments for sub-cent payments. Gasless USDC micropayments down to $0.000001 via x402 and batched settlement. For pay-per-request APIs, AI agent payments, streaming.","Look up USDC addresses per chain. Never hardcode — use https://developers.circle.com/stablecoins/usdc-contract-addresses.md.","Prefer SDKs over raw API calls. Node.js and Python SDKs handle auth, retries, and errors.","API key required. Bearer token in Authorization header. Testnet and mainnet use separate keys and may use different base URLs depending on the product.","Set up webhooks when available. Most operations are async. Webhooks deliver transaction confirmations and state changes.","When calling list endpoints, paginate using pageSize and pageAfter until no nextPageAfter cursor is returned—stopping at the first page silently misses records.","Building an AI agent? Start with the Agent Stack—Circle CLI, agent wallets, and nanopayments built for autonomous use cases: https://developers.circle.com/agent-stack.md."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"circle-167b8d39","hasAudioNarration":false,"actualSubdomain":"circle-167b8d39","customDomains":["developers.circle.com"],"gitSource":{"type":"github","owner":"crcl-main","repo":"circle-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4f0c12054f82e5056fc19","collectionId":"3a748168-6a54-4917-942b-3921a57caa17","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4f0c12054f82e5056fc19"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4f0c12054f82e5056fc19","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API reference","count":587},{"language":"default","tag":"Wallets","count":159},{"language":"default","tag":"Circle Payments Network","count":156},{"language":"default","tag":"Mint and Custody","count":124},{"language":"default","tag":"StableFX","count":108},{"language":"default","tag":"Digital Asset Accounts","count":104},{"language":"default","tag":"Liquidity services","count":104},{"language":"default","tag":"Crosschain transfers","count":100},{"language":"default","tag":"Payments","count":91},{"language":"default","tag":"Managed Payments","count":75}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":false},"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":"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":"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":"instinct-self-updating-docs","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":"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":"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":"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}],"googleFontsInlined":false},"customCss":[{"filePath":"snippets/SDKCard.css","content":".cb-card{border:1px solid #e5e7eb;border-radius:12px;background:#fff;box-shadow:0 1px 3px 0 rgba(0,0,0,.1)}.cb-icon-circle{display:flex;align-items:center;justify-content:center;border-radius:50%;flex-shrink:0}.accent-orange{background-color:#fff7ed;color:#ea580c}.accent-blue{background-color:#eff6ff;color:#2563eb}.accent-green{background-color:#f0fdf4;color:#16a34a}.accent-purple{background-color:#faf5ff;color:#9333ea}.accent-violet{background-color:#f5f3ff;color:#7c3aed}.type-header-xs{font-size:18px;font-weight:600;line-height:1.4;color:#111827}.type-body-base{font-size:14px;line-height:1.5;color:#6b7280}.type-body-xs-bold{font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:#6b7280}.type-body-sm{font-size:14px;line-height:1.5;color:#374151}.type-body-sm-bold{font-size:14px;font-weight:600;line-height:1.5}.text-icon-neutral,.text-neutral-subtle{color:#6b7280}.cb-button{display:inline-flex;align-items:center;padding:8px 16px;border-radius:8px;font-size:14px;font-weight:500;text-decoration:none;transition:all .2s;border:1px solid #e5e7eb;background:#fff;color:#374151}.cb-button:hover{background:#f9fafb;border-color:#d1d5db}"},{"filePath":"style.css","content":":root{--background-dark:17 24 39!important}html.dark .accordion,html.dark .card{background-color:#111827!important}#navbar .navbar-link a,#navbar [data-component-name=theme-toggle],#navbar a[href*=\"console.circle.com\"],#navbar a[href*=\"faucet.circle.com\"]{background-color:rgba(17,24,39,.03)!important}#navbar .navbar-link a:hover,#navbar [data-component-name=theme-toggle]:hover,#navbar a[href*=\"console.circle.com\"]:hover,#navbar a[href*=\"faucet.circle.com\"]:hover{background-color:rgba(17,24,39,.07)!important}@media (prefers-color-scheme:dark){#navbar .navbar-link a,#navbar [data-component-name=theme-toggle],#navbar a[href*=\"console.circle.com\"],#navbar a[href*=\"faucet.circle.com\"]{background-color:rgba(255,255,255,.05)!important}#navbar .navbar-link a:hover,#navbar [data-component-name=theme-toggle]:hover,#navbar a[href*=\"console.circle.com\"]:hover,#navbar a[href*=\"faucet.circle.com\"]:hover{background-color:rgba(255,255,255,.1)!important}}html.dark #navbar .navbar-link a,html.dark #navbar [data-component-name=theme-toggle],html.dark #navbar a[href*=\"console.circle.com\"],html.dark #navbar a[href*=\"faucet.circle.com\"]{background-color:rgba(255,255,255,.05)!important}html.dark #navbar .navbar-link a:hover,html.dark #navbar [data-component-name=theme-toggle]:hover,html.dark #navbar a[href*=\"console.circle.com\"]:hover,html.dark #navbar a[href*=\"faucet.circle.com\"]:hover{background-color:rgba(255,255,255,.1)!important}html.dark #feedback-form-submit,html.dark #topbar-cta-button,html.dark #topbar-cta-button a,html.dark a[class*=\"bg-[#0073C3]\"],html.dark a[class*=\"bg-[#0073C3]\"] svg,html.dark a[class*=\"bg-[#1AA3FF]\"],html.dark a[class*=\"bg-[#1AA3FF]\"] svg,html.dark a[class*=\"bg-[#5FBFFF]\"],html.dark a[class*=\"bg-[#5FBFFF]\"] svg,html.dark a[class*=\"bg-[#90D2FF]\"],html.dark a[class*=\"bg-[#90D2FF]\"] svg,html.dark chat-assistant-send-button,html.dark code-snippet-feedback-form-submit-button,html.dark contextual-feedback-form-submit-button,html.dark tryit-button{color:#000!important}.mcp-setup-container{display:flex;flex-wrap:wrap;gap:24px;margin:20px 0 28px}.mcp-setup-section{display:flex;flex-direction:column;gap:8px}.mcp-setup-label{font-size:.75rem;font-weight:500;text-transform:uppercase;letter-spacing:.05em;color:#64748b}.dark .mcp-cta-cli:hover .mcp-cli-icon-wrap svg,.dark .mcp-setup-label{color:#94a3b8}.mcp-cta-group{display:flex;flex-wrap:wrap;gap:10px}.mcp-cta{height:40px;border-radius:12px;font-weight:600;font-size:.875rem;padding:0 16px;text-decoration:none!important;display:inline-flex;align-items:center;gap:8px;border:1px solid rgba(15,23,42,.15);background-color:#f8fafc;color:#0b0f19;transition:background-color .15s ease,border-color .15s ease;cursor:pointer}.mcp-cta:hover{background-color:#f1f5f9;border-color:rgba(15,23,42,.25)}.mcp-cta img{width:20px;height:20px;object-fit:contain;border-radius:6px;flex-shrink:0}.mcp-cta span{white-space:nowrap}.dark .mcp-cta{border-color:rgba(255,255,255,.2);background-color:rgba(255,255,255,.08);color:#f8fafc}.dark .mcp-cta:hover{background-color:rgba(255,255,255,.12);border-color:rgba(255,255,255,.3)}.mcp-cta-cli{background-color:#f1f5f9;border-color:#e2e8f0}.mcp-cta-cli:hover{background-color:#e2e8f0;border-color:#cbd5e1}.dark .mcp-cta-cli{background-color:rgba(255,255,255,.06);border-color:rgba(255,255,255,.15)}.dark .mcp-cta-cli:hover{background-color:rgba(255,255,255,.1);border-color:rgba(255,255,255,.25)}.mcp-cli-label{font-weight:600;color:#0f172a}.dark .mcp-cli-label{color:#f1f5f9}.mcp-cli-cmd{font-size:.75rem;font-family:ui-monospace,SFMono-Regular,\"SF Mono\",Menlo,Consolas,monospace;color:#64748b;background:0 0!important;padding:0;white-space:nowrap;border:0}.dark .mcp-cli-cmd{color:#94a3b8;background:0 0!important}.mcp-cli-icon-wrap{display:flex;align-items:center;justify-content:center;flex-shrink:0;width:14px;height:14px;position:relative}.mcp-cli-icon-wrap svg{color:#94a3b8;transition:opacity .15s ease}.dark .mcp-cli-icon-wrap svg,.mcp-cta-cli:hover .mcp-cli-icon-wrap svg{color:#64748b}.mcp-icon-check{position:absolute;opacity:0;color:#22c55e!important}.mcp-cta-cli.copied .mcp-icon-copy{opacity:0}.mcp-cta-cli.copied .mcp-icon-check{opacity:1}.dark .mcp-cli-openai-logo{filter:invert(1)}table thead{text-align:left;background-color:#f5f5f8}.dark table thead{text-align:left;background-color:#29233b}table td,table thead th{padding:8px!important}.accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]){background-color:#e1f2ff!important;border-color:#c9e1f5!important}.accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) summary:hover{background-color:#c9e1f5!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]){background-color:#1f1a30!important;border-color:#29233b!important}.accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) summary,.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) summary{transition:background-color .3s ease!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) summary:hover{background-color:#29233b!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) [data-component-part=accordion-title]{color:#fff!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) [data-component-part=accordion-content]{color:#e5e7eb!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) [data-component-part=accordion-content] a{color:#1aa3ff!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) [data-component-part=accordion-content] a:hover{color:#1894e8!important}.dark .accordion:has([data-component-part=accordion-icon] svg[style*=\"circle-info.svg\"]) [data-component-part=accordion-content] code{color:#fbbf24!important;background-color:#374151!important}.TryItOutComponent code,.TryItOutComponent pre{background-color:transparent!important}.TryItOutComponent .code-container{background-color:#fff!important}.dark .TryItOutComponent .code-container{background-color:#29233b!important}.home_code_container .code-block{margin:0!important;height:100%}.home_code_container .code-block .code-block-background{height:100%!important}.home_mint_cards a.card>div{padding:20px!important}.home_mint_cards h2{color:#29233b!important}.home_mint_cards div.prose span{color:#6b6580!important}.dark .home_mint_cards h2{color:#fff!important}.dark .home_mint_cards div.prose span{color:#9ca3af!important}#footer svg[style*=mask-image],.home_mint_cards a.card svg{background-color:#6b6580!important}.home_mint_cards a.card:hover svg{background:linear-gradient(135deg,#5fbfff 0,#b090f5 100%)!important}.home_tryitout{background:linear-gradient(89deg,var(--background-gradient-bg-accent-purple-gradient-bottom-left,\n rgba(241, 235, 255, 0.5)\n ) 0%,var(--background-gradient-bg-accent-purple-gradient-top-right,\n rgba(225, 242, 255, 0.5)\n ) 94.58%)}.dark .home_tryitout{background:linear-gradient(89deg,var(--background-gradient-bg-accent-purple-gradient-bottom-left,\n rgba(44, 44, 44, 0.5)\n ) 0%,var(--background-gradient-bg-accent-purple-gradient-top-right,\n rgba(75, 82, 86, 0.5)\n ) 94.58%)}.quickstart-cards-aligned [data-component-part=card-group]{gap:16px!important}.asset-card-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:1.5rem;margin:1.5rem 0;align-items:stretch}.asset-card{border:1px solid #e5e7eb;border-radius:1rem;background:0 0;padding:1rem 1.25rem 1.5rem;text-decoration:none;color:inherit;display:flex;flex-direction:column;justify-content:space-between;gap:.45rem;transition:border-color .2s ease,box-shadow .2s ease,transform .2s ease;height:100%}.asset-card:hover{border-color:#cfd3dc;box-shadow:0 12px 24px rgba(15,23,42,.08);transform:translateY(-2px)}.dark .asset-card{border-color:rgba(148,163,184,.14);background:0 0;box-shadow:none}.asset-card h3{font-size:1.125rem;font-weight:600;margin:0;color:#0f172a}.dark .asset-card h3{color:#f8fafc}.asset-card p{margin:0;font-weight:300;color:#475569}.dark .asset-card p{color:#b8b8b8}.asset-card-image-wrapper,.asset-card-inline-icon{width:56px;height:56px;border-radius:9999px;margin-bottom:.6rem;flex-shrink:0}.asset-card-image-wrapper{overflow:hidden;display:flex;align-items:center;justify-content:center;background:rgba(15,23,42,.05)}.dark .asset-card-image-wrapper{background:rgba(248,250,252,.08)}.asset-card-image{width:100%;height:100%;object-fit:cover;display:block}.asset-card-inline-icon{padding:10px;display:flex;align-items:center;justify-content:center;background:linear-gradient(135deg,rgba(0,96,255,.18),rgba(0,164,255,.05));color:#0d5be1}.dark .asset-card-inline-icon{background:rgba(255,255,255,.08);color:#82b7ff}.asset-card-inline-icon svg{width:26px;height:26px}.asset-card.secondary{justify-content:flex-start}.quickstart-cards-aligned [data-component-part=card],.quickstart-cards-aligned [data-component-part=card]>div,.quickstart-cards-aligned a.card,.quickstart-cards-aligned a.card>div{display:flex!important;flex-direction:column!important;height:100%!important}.quickstart-cards-aligned [data-component-part=card]>div>.prose,.quickstart-cards-aligned a.card>div>.prose{flex-grow:1!important;display:flex!important;flex-direction:column!important}.quickstart-cards-aligned [data-component-part=card]>div>div:last-child,.quickstart-cards-aligned a.card>div>div:last-child{margin-top:auto!important}@media (max-width:1024px){.quickstart-cards-aligned,div.quickstart-cards-aligned{display:flex!important;flex-direction:column!important;gap:4px!important}.quickstart-cards-aligned [data-component-part=card-group],.quickstart-cards-aligned>div,div.quickstart-cards-aligned [data-component-part=card-group],div.quickstart-cards-aligned>div{display:flex!important;flex-direction:column!important;gap:4px!important;row-gap:4px!important;grid-row-gap:4px!important;width:100%!important}.quickstart-cards-aligned [data-component-part=card],.quickstart-cards-aligned a.card,div.quickstart-cards-aligned a.card{margin-bottom:4px!important;width:100%!important}.quickstart-cards-aligned [data-component-part=card]:last-child,.quickstart-cards-aligned a.card:last-child,div.quickstart-cards-aligned a.card:last-child{margin-bottom:0!important}}footer,footer [data-component-part=footer-section],footer [data-component-part=footer],footer>div{overflow-x:hidden!important;max-width:100%!important;padding-top:1.75rem!important}#your-privacy-choices-button,footer .footer-link,footer [data-component-part=footer-link],footer a{overflow-wrap:normal!important;word-wrap:normal!important;word-break:keep-all!important;hyphens:none!important;font-size:.75rem!important;white-space:normal!important;max-width:100%!important;line-height:1.4!important;min-width:0!important}#footer a,#your-privacy-choices-button{color:#6b6580!important}html.dark #footer a,html.dark #your-privacy-choices-button{color:#8a849c!important}#footer a:hover,#footer a[href*=mintlify]:hover,#footer a[href*=mintlify]:hover span,#footer a[href*=mintlify]:hover svg,#your-privacy-choices-button:hover{color:#4e4763!important}html.dark #footer a:hover,html.dark #footer a[href*=mintlify]:hover,html.dark #footer a[href*=mintlify]:hover span,html.dark #footer a[href*=mintlify]:hover svg,html.dark #your-privacy-choices-button:hover{color:#a7a3b5!important}#your-privacy-choices-button{position:relative;align-self:start}footer .md\\:items-center>div:has(>#your-privacy-choices-button){align-self:flex-start!important}#your-privacy-choices-button::after{content:url(https://6778953.fs1.hubspotusercontent-na1.net/hubfs/6778953/legal/opt-out-30x14.svg);right:-34px;position:absolute}#footer>div{gap:12px;padding-bottom:20px}#footer a[href*=mintlify],#footer a[href*=mintlify] span,#footer a[href*=mintlify] svg{color:#6b6580!important;fill:currentColor!important}html.dark #footer a[href*=mintlify],html.dark #footer a[href*=mintlify] span,html.dark #footer a[href*=mintlify] svg{color:#8a849c!important}#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex:has([data-powered-by-relocated]){flex:0 0 auto!important;width:auto!important;max-width:200px!important}#footer [data-powered-by-relocated]{flex:0 0 100%!important;display:flex!important;justify-content:flex-end!important;margin-top:.25rem!important}#footer [data-powered-by-relocated] a[href*=mintlify]{font-size:.75rem!important}#footer [data-powered-by-relocated] a[href*=mintlify] svg{height:.75rem!important;width:auto!important}#footer [data-powered-by-relocated]>:not(:has(a[href*=mintlify])){display:none!important}@media (max-width:767px){#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex{display:flex!important;justify-content:flex-end!important}#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex>a{display:none!important}}html.dark #footer svg[style*=mask-image]{background-color:#8a849c!important}#footer a:hover svg[style*=mask-image]{background-color:#4e4763!important}html.dark #footer a:hover svg[style*=mask-image]{background-color:#a7a3b5!important}"}],"page":{"pagePath":"api-reference/end-user-onboarding/create-partner-client","slug":"/api-reference/end-user-onboarding/create-partner-client","pageMetadata":{"openapi":"openapi/customer-orchestration.yaml post /v1/partner/clients","title":"Create a partner client","description":"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the `clientEntityId` and the `applicationId` for the newly created draft application.\n\nEach `clientName` and `country` combination identifies one client. Submitting a combination that already exists returns the existing client's `clientEntityId` and `applicationId` instead of creating a new client. A `409 Conflict` error means two requests created the same client at once; retry the request.","href":"/api-reference/end-user-onboarding/create-partner-client"},"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: [_jsxs(_components.p, {\n children: [\"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the \", _jsx(_components.code, {\n children: \"clientEntityId\"\n }), \" and the \", _jsx(_components.code, {\n children: \"applicationId\"\n }), \" for the newly created draft application.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Each \", _jsx(_components.code, {\n children: \"clientName\"\n }), \" and \", _jsx(_components.code, {\n children: \"country\"\n }), \" combination identifies one client. Submitting a combination that already exists returns the existing client’s \", _jsx(_components.code, {\n children: \"clientEntityId\"\n }), \" and \", _jsx(_components.code, {\n children: \"applicationId\"\n }), \" instead of creating a new client. A \", _jsx(_components.code, {\n children: \"409 Conflict\"\n }), \" error means two requests created the same client at once; retry the request.\"]\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":{"openapi":"openapi/customer-orchestration.yaml post /v1/partner/clients","title":"Create a partner client","description":"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the `clientEntityId` and the `applicationId` for the newly created draft application.\n\nEach `clientName` and `country` combination identifies one client. Submitting a combination that already exists returns the existing client's `clientEntityId` and `applicationId` instead of creating a new client. A `409 Conflict` error means two requests created the same client at once; retry the request.","href":"/api-reference/end-user-onboarding/create-partner-client"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/circle-167b8d39/d67aae5e94f8afee/content/gtm.js","/_mintlify/custom/circle-167b8d39/df50992471c6ad37/content/footer-powered-by.js"],"openApiReferenceData":{"operation":{"security":["0c19d6d7-77e8-4196-9f23-0fa2e876bf2c"],"summary":"Create a partner client","description":"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the `clientEntityId` and the `applicationId` for the newly created draft application.\n\nEach `clientName` and `country` combination identifies one client. Submitting a combination that already exists returns the existing client's `clientEntityId` and `applicationId` instead of creating a new client. A `409 Conflict` error means two requests created the same client at once; retry the request.","operationId":"createPartnerClient","tags":["Partner Clients"],"requestBody":"2b908eb8-4361-4090-abec-292d8852303b","responses":{"200":"a734affc-a294-4964-81a4-40d36224ce9d","401":"d0073681-af29-4c34-a981-24f391f370cc","403":"82fdc485-e481-49ae-ab83-048233d555c0","409":"50ac379b-51a7-4948-8b97-5674a3084252"},"method":"post","type":"path","servers":["66f131cd-1c40-4062-aa50-51525e09a86e","19b7131c-6a04-4eab-a391-bbb3464d592e"],"path":"/v1/partner/clients","baseUrlOptions":["https://api-sandbox.circle.com","https://api.circle.com"],"title":"Create a partner client","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["businessDetails","clientName","clientType","country"],"properties":{"clientName":{"type":"string","description":"Name for the client entity.","example":"Acme Trust Co.","isRequired":true,"uniqueKey":"clientName","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code for the client's primary jurisdiction.","example":"US","minLength":2,"maxLength":2,"isRequired":true,"uniqueKey":"country","typeLabel":"string"},"clientType":{"type":"string","description":"Type of client. Currently `business` is the only supported value.","enum":["business"],"example":"business","isRequired":true,"uniqueKey":"clientType","typeLabel":"enum\u003cstring>"},"businessDetails":{"type":"object","description":"Business-specific details. On create, required only when `clientType` is `business` — omit this object for non-business client types. On reads, returned for business clients with the values submitted at creation.","required":["institutionType","natureOfBusiness"],"properties":{"natureOfBusiness":{"type":"string","description":"Industry classification for the business. Determines which sections and fields appear in the onboarding application.","enum":["accommodation","accounting","agriculture","art","assetManager","banking","brokerageOTC","construction","cryptoATM","cryptoCustodian","cryptoExchange","cryptoInvesting","cryptoSoftwareProvider","daOrg","dexAdmin","eCommercePlatform","education","familyOffice","film","healthCare","hedgeFund","insurance","manufacturingAutomobiles","manufacturingElectronics","manufacturingHighValueGoods","manufacturingOther","marketMaker","marketing","mining","miningPool","nftMarketplace","nonProfit","otherCryptoServices","otherOperatingCompanies","otherPooledInvestmentVehicles","p2p","paymentProcessorPlatform","personalInvestment","privateEquityFund","privateFoundation","publicCharity","realEstate","stakingServices","tokenProject","trading","transportation","trust","utilities","ventureCapitalFund","web3GamingSocial"],"example":"paymentProcessorPlatform","isRequired":true,"uniqueKey":"businessDetails.natureOfBusiness","typeLabel":"enum\u003cstring>"},"institutionType":{"type":"string","description":"Legal entity type of the business.","enum":["associationOrConsortium","coop","foundation","governmentBody","partnership","privateCo","publicCo","soleTrader","trust"],"example":"privateCo","isRequired":true,"uniqueKey":"businessDetails.institutionType","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"businessDetails","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"clientName":"Acme Trust Co.","country":"US","clientType":"business","businessDetails":{"natureOfBusiness":"paymentProcessorPlatform","institutionType":"privateCo"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a734affc-a294-4964-81a4-40d36224ce9d":{"description":"Client created and application initialized","headers":{"X-Request-Id":{"description":"Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"clientEntityId":{"type":"string","format":"uuid","description":"Unique identifier for the newly created client entity.","example":"880e8400-e29b-41d4-a716-446655440099","uniqueKey":"data.clientEntityId","typeLabel":"string\u003cuuid>"},"applicationId":{"type":"string","format":"uuid","description":"Unique identifier for the draft onboarding application created for this client.","example":"550e8400-e29b-41d4-a716-446655440000","uniqueKey":"data.applicationId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"clientEntityId":"880e8400-e29b-41d4-a716-446655440099","applicationId":"550e8400-e29b-41d4-a716-446655440000"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d0073681-af29-4c34-a981-24f391f370cc":{"description":"The request has not been applied because it lacks valid authentication credentials.","headers":{"X-Request-Id":{"description":"Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"schema":{"type":"object","title":"NotAuthorized","required":["code","message"],"properties":{"code":{"type":"integer","example":401,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Malformed authorization.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"NotAuthorized · object"},"examples":{"Example":{"title":"Example","value":{"code":401,"message":"Malformed authorization."}}},"exampleType":"generated"}},"exampleType":"generated"},"82fdc485-e481-49ae-ab83-048233d555c0":{"description":"The request provides authentication, but the authenticated user does not possess sufficient permissions for accessing this resource.","headers":{"X-Request-Id":{"description":"Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"schema":{"type":"object","title":"Forbidden","required":["code","message"],"properties":{"code":{"type":"integer","example":403,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"Forbidden","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"Forbidden · object"},"examples":{"Example":{"title":"Example","value":{"code":403,"message":"Forbidden"}}},"exampleType":"generated"}},"exampleType":"generated"},"50ac379b-51a7-4948-8b97-5674a3084252":{"description":"A client with the same `clientName` and `country` combination already exists. Use a different `clientName` to create another client in the same country.","headers":{"X-Request-Id":{"description":"Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"schema":{"type":"object","title":"Conflict","required":["code","message"],"properties":{"code":{"type":"integer","example":409,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","example":"A client with this name and country already exists.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"Conflict · object"},"examples":{"Example":{"title":"Example","value":{"code":409,"message":"A client with this name and country already exists."}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0c19d6d7-77e8-4196-9f23-0fa2e876bf2c":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"66f131cd-1c40-4062-aa50-51525e09a86e":{"url":"https://api-sandbox.circle.com"},"19b7131c-6a04-4eab-a391-bbb3464d592e":{"url":"https://api.circle.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/customer-orchestration.yaml"},"subdomain":"circle-167b8d39","siteName":"Circle Docs","title":"Create a partner client - Circle Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T15:09:59.275Z","originalFileLocation":"api-reference/end-user-onboarding/create-partner-client.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 client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application. Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client\u0026#x27;s clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Circle Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a partner client - Circle Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application. Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client\u0026#x27;s clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Circle Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://circle-167b8d39.mintlify.app/_mintlify/api/og/v2?division=Partner+clients\u0026amp;title=Create+a+partner+client\u0026amp;description=Creates+a+new+client+entity+and+initializes+an+onboarding+application+in+a+single+request.+The+response+contains+both+the+%60clientEntityId%60+and+the+%60applicationI\u0026amp;theme=5260492f3b2b0d8ab3e7e4f3\u0026amp;signature=029326e43d0a2e8b7606402f6dbfa7d1a8dff98ca6c729e5adfde68e35677ebe\">\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 partner client - Circle Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application. Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client\u0026#x27;s clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://circle-167b8d39.mintlify.app/_mintlify/api/og/v2?division=Partner+clients\u0026amp;title=Create+a+partner+client\u0026amp;description=Creates+a+new+client+entity+and+initializes+an+onboarding+application+in+a+single+request.+The+response+contains+both+the+%60clientEntityId%60+and+the+%60applicationI\u0026amp;theme=5260492f3b2b0d8ab3e7e4f3\u0026amp;signature=029326e43d0a2e8b7606402f6dbfa7d1a8dff98ca6c729e5adfde68e35677ebe\">\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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Circle Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0073C3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/end-user-onboarding/create-partner-client.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.circle.com/#organization\",\"name\":\"Circle Docs\",\"url\":\"https://developers.circle.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/light.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=decfb42837e0eb7c32dd425866902e78\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.circle.com#website\",\"name\":\"Circle Docs\",\"url\":\"https://developers.circle.com\",\"publisher\":{\"@id\":\"https://developers.circle.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client#webpage\",\"url\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client\",\"name\":\"Create a partner client\",\"description\":\"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application. Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client's clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.\",\"dateModified\":\"2026-09-29T15:09:59.275Z\",\"isPartOf\":{\"@id\":\"https://developers.circle.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Circle Docs\",\"item\":\"https://developers.circle.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a partner client\",\"item\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client#apireference\",\"headline\":\"Create a partner client\",\"name\":\"Create a partner client\",\"description\":\"Creates a new client entity and initializes an onboarding application in a single request. The response contains both the clientEntityId and the applicationId for the newly created draft application. Each clientName and country combination identifies one client. Submitting a combination that already exists returns the existing client's clientEntityId and applicationId instead of creating a new client. A 409 Conflict error means two requests created the same client at once; retry the request.\",\"url\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client\",\"mainEntityOfPage\":{\"@id\":\"https://developers.circle.com/api-reference/end-user-onboarding/create-partner-client#webpage\"},\"dateModified\":\"2026-09-29T15:09:59.275Z\",\"publisher\":{\"@id\":\"https://developers.circle.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.circle.com#website\"}}]}\u003c/script>","siteName":"Circle Docs","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":""}]},{"tab":"Assets","pages":[{"title":"Assets","href":"/assets"}]},{"tab":"Build onchain","pages":[{"title":"Build onchain","href":"/build-onchain"}]},{"tab":"Crosschain transfers","pages":[{"title":"Crosschain transfers","href":"/crosschain-transfers"}]},{"tab":"Agent stack","pages":[{"title":"Agent stack","href":"/agent-stack"}]},{"tab":"Payments","pages":[{"title":"Payments","href":"/cpn"}]},{"tab":"Liquidity services","pages":[{"title":"Liquidity services","href":"/liquidity-services"}]},{"tab":"API reference","anchors":[{"anchor":"Home","icon":"home","pages":[{"title":"Home","href":"/api-reference"}]},{"anchor":"Wallets","icon":"wallet","pages":[{"title":"Wallets","href":"/api-reference/wallets"}]},{"anchor":"Contracts","icon":"file-contract","pages":[{"title":"Contracts","href":"/api-reference/contracts"}]},{"anchor":"CCTP","icon":"bridge","pages":[{"title":"CCTP","href":"/api-reference/cctp"}]},{"anchor":"Gateway","icon":"dungeon","pages":[{"title":"Gateway","href":"/api-reference/gateway"}]},{"anchor":"x402 facilitators","icon":"handshake","pages":[{"title":"x402 facilitators","href":"/api-reference/x402-facilitators"}]},{"anchor":"Digital Asset Accounts","icon":"money-bill-1-wave","pages":[{"title":"Digital Asset Accounts","href":"/api-reference/digital-asset-accounts"}]},{"anchor":"End User Onboarding","icon":"user-plus","pages":[{"title":"End User Onboarding API","sidebarTitle":"Overview","href":"/api-reference/end-user-onboarding"},{"title":"End User Onboarding API error codes","description":"Numeric error codes returned by the End User Onboarding API, with HTTP status, public message, and partner action.","sidebarTitle":"Error codes","href":"/api-reference/end-user-onboarding/error-codes"},{"group":"End User Onboarding","pages":[{"group":"Partner clients","pages":[{"openapi":"openapi/customer-orchestration.yaml post /v1/partner/clients","title":"Create a partner client","href":"/api-reference/end-user-onboarding/create-partner-client"},{"openapi":"openapi/customer-orchestration.yaml get /v1/partner/clients/{clientEntityId}","title":"Get a partner client","description":"Returns a single client by its `clientEntityId`, scoped to your partner account. Requesting a client that does not exist — or one that belongs to a different partner — returns a `404 Not Found` error.\n\nThe response always carries the `clientEntityId` and `created` timestamp. The profile fields (`clientName`, `country`, `clientType`, `businessDetails`) echo the details submitted at creation, while `status` and `balances` are enriched by Circle and omitted when not available.","href":"/api-reference/end-user-onboarding/get-partner-client"},{"openapi":"openapi/customer-orchestration.yaml get /v1/partner/clients","title":"List partner clients","href":"/api-reference/end-user-onboarding/list-partner-clients"}]},{"group":"Partner applications","pages":[{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications","title":"List applications for the authenticated partner","href":"/api-reference/end-user-onboarding/list-applications"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}","title":"Retrieve an application by ID","href":"/api-reference/end-user-onboarding/get-application"},{"openapi":"openapi/partner-openapi.yaml delete /v1/onboarding/partner/applications/{applicationId}","title":"Cancel an application","href":"/api-reference/end-user-onboarding/cancel-application"},{"openapi":"openapi/partner-openapi.yaml patch /v1/onboarding/partner/applications/{applicationId}/data","title":"Save data for multiple sections in a single request","href":"/api-reference/end-user-onboarding/bulk-save"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/data","title":"Retrieve data for all visible sections","href":"/api-reference/end-user-onboarding/get-all-data"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/schema","title":"Get the JSON Schema (draft 2020-12) for an application's template","href":"/api-reference/end-user-onboarding/get-application-schema"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/certifications","title":"List active certifications for an application","href":"/api-reference/end-user-onboarding/get-certifications"},{"openapi":"openapi/partner-openapi.yaml post /v1/onboarding/partner/applications/{applicationId}/submit","title":"Submit an application","href":"/api-reference/end-user-onboarding/submit-application"}]},{"group":"Partner documents","pages":[{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/documents","title":"List documents for an application","href":"/api-reference/end-user-onboarding/list-documents"},{"openapi":"openapi/partner-openapi.yaml post /v1/onboarding/partner/applications/{applicationId}/documents","title":"Upload a document for an application","href":"/api-reference/end-user-onboarding/upload-document"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/documents/{documentId}","title":"Download a document","href":"/api-reference/end-user-onboarding/download-document"},{"openapi":"openapi/partner-openapi.yaml delete /v1/onboarding/partner/applications/{applicationId}/documents/{documentId}","title":"Delete a document","href":"/api-reference/end-user-onboarding/delete-document"}]},{"group":"Partner RFIs","pages":[{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/rfis","title":"List RFI bundles for an application","href":"/api-reference/end-user-onboarding/list-rfis"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/rfis/{rfiId}","title":"Get RFI detail with comment history","href":"/api-reference/end-user-onboarding/get-rfi"},{"openapi":"openapi/partner-openapi.yaml patch /v1/onboarding/partner/applications/{applicationId}/rfis/{rfiId}","title":"Submit field data in response to an UPDATE_FIELD or NEW_FIELD RFI","href":"/api-reference/end-user-onboarding/update-rfidata"},{"openapi":"openapi/partner-openapi.yaml post /v1/onboarding/partner/applications/{applicationId}/rfis/{rfiId}/comments","title":"Add a comment to an RFI","href":"/api-reference/end-user-onboarding/create-comment"},{"openapi":"openapi/partner-openapi.yaml put /v1/onboarding/partner/applications/{applicationId}/rfis/{rfiId}/comments/{commentId}","title":"Update a comment on an RFI","href":"/api-reference/end-user-onboarding/update-comment"},{"openapi":"openapi/partner-openapi.yaml delete /v1/onboarding/partner/applications/{applicationId}/rfis/{rfiId}/comments/{commentId}","title":"Delete a comment on an RFI","href":"/api-reference/end-user-onboarding/delete-comment"}]},{"group":"Partner sections","pages":[{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/sections","title":"List sections for an application","href":"/api-reference/end-user-onboarding/list-sections"},{"openapi":"openapi/partner-openapi.yaml get /v1/onboarding/partner/applications/{applicationId}/sections/{sectionName}","title":"Retrieve section data for an application","href":"/api-reference/end-user-onboarding/get-section"},{"openapi":"openapi/partner-openapi.yaml put /v1/onboarding/partner/applications/{applicationId}/sections/{sectionName}","title":"Save section data for an application","href":"/api-reference/end-user-onboarding/save-section"},{"openapi":"openapi/partner-openapi.yaml delete /v1/onboarding/partner/applications/{applicationId}/sections/{sectionName}/{refId}","title":"Remove an entity from an array section","href":"/api-reference/end-user-onboarding/remove-entity"}]}]}]},{"anchor":"Mint and Custody","icon":"building-columns","pages":[{"title":"Mint and Custody","href":"/api-reference/circle-mint"}]},{"anchor":"Circle Payments Network","icon":"chart-network","pages":[{"title":"Circle Payments Network","href":"/api-reference/cpn"}]},{"anchor":"StableFX","icon":"swap","pages":[{"title":"StableFX","href":"/api-reference/stablefx"}]},{"anchor":"xReserve","icon":"vault","pages":[{"title":"xReserve","href":"/api-reference/xreserve"}]},{"anchor":"Match","pages":[{"title":"Match","href":"/api-reference/circle-match/all/get-account"}]}]},{"tab":"Developer tools","menu":[{"item":"Sample projects","pages":[{"title":"Sample projects","href":"/sample-projects"}]},{"item":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]},{"item":"Release notes","pages":[{"title":"Release notes","href":"/release-notes"}]}],"pages":[{"title":"Developer tools","href":"/sample-projects"}]}]},"basePath":"","title":"Create a partner client - Circle Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}