{
"code": "invalid_request",
"error": "Request body is invalid."
}
{
"code": "unauthorized",
"error": "A valid workspace API key is required."
}
{
"code": "insufficient_scope",
"error": "This API key is missing the required scope."
}
{
"code": "rate_limited",
"error": "Too many API requests. Slow down and try again shortly."
}
{
"code": "internal_error",
"error": "The API request could not be completed."
}
Create client
Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Woes","description":"Customer-facing documentation and REST API reference for Woes, the API-native developer support platform.","colors":{"primary":"#B83A12","light":"#E05A22","dark":"#E05A22"},"logo":{"light":"https://mintcdn.com/woes/QdK5garcQwoPsAlm/images/woes-wordmark.png?fit=max\u0026auto=format\u0026n=QdK5garcQwoPsAlm\u0026q=85\u0026s=5fb012a2064e1898482aab3a15aa40fc","dark":"https://mintcdn.com/woes/QdK5garcQwoPsAlm/images/woes-wordmark.png?fit=max\u0026auto=format\u0026n=QdK5garcQwoPsAlm\u0026q=85\u0026s=5fb012a2064e1898482aab3a15aa40fc"},"favicon":"https://mintcdn.com/woes/z9C4KzvBjjdD9uds/images/woes-mark.png?fit=max\u0026auto=format\u0026n=z9C4KzvBjjdD9uds\u0026q=85\u0026s=d0f6cf6c6931b5f50b6fb075aefffe6e","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","node","python","javascript"],"prefill":true},"url":"full"},"background":{"decoration":"grid","color":{"light":"#FFF8F2","dark":"#11100F"}},"navbar":{"links":[{"href":"https://docs.woes.dev","label":"Docs"},{"href":"https://docs.woes.dev/api-reference/overview","label":"API Reference"},{"href":"https://docs.woes.dev/security/data-privacy","label":"Trust"},{"href":"https://woes.dev","label":"App"}],"primary":{"type":"button","label":"Open app","href":"https://woes.dev"}},"footer":{"links":[{"header":"Product","items":[{"label":"Quickstart","href":"/quickstart/overview"},{"label":"Support Workflows","href":"/support-workflows/omnichannel-support"},{"label":"Chat Widget","href":"/chat-widget/overview"},{"label":"Website","href":"https://woes.dev"},{"label":"Blog","href":"https://woes.dev/blog"}]},{"header":"Knowledge","items":[{"label":"Knowledge Base","href":"/knowledge-base/overview"},{"label":"AI Agents","href":"/agents/overview"},{"label":"Analytics","href":"/platform/analytics"}]},{"header":"Developer","items":[{"label":"Developer Overview","href":"/developer/overview"},{"label":"API Reference","href":"/api-reference/overview"},{"label":"Authentication","href":"/api/authentication"}]},{"header":"Security","items":[{"label":"Widget Identity","href":"/security/widget-identity"},{"label":"Data Privacy","href":"/security/data-privacy"},{"label":"Tenant Isolation","href":"/security/tenant-isolation"}]}]},"search":{"prompt":"Search Woes docs, API guides, and endpoint reference..."},"seo":{"metatags":{"og:site_name":"Woes Docs","twitter:card":"summary_large_image"},"indexing":"navigable"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":false},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"woes","hasAudioNarration":false,"actualSubdomain":"woes","customDomains":["docs.woes.dev"],"gitSource":{"type":"github","owner":"spazman2c","repo":"woesdocs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"e11cbd83-504b-4a19-83e1-400e755437d0","liveDeploymentHistoryId":"6a495fcd7c1f63e9b6fe6af5","schemaVersion":"v3"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a495fcd7c1f63e9b6fe6af5:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Docs","count":73},{"language":"default","tag":"Woes documentation","count":73},{"language":"default","tag":"API Reference","count":45},{"language":"default","tag":"API reference","count":45},{"language":"default","tag":"Integrations","count":28},{"language":"default","tag":"Endpoint reference","count":28},{"language":"default","tag":"Support workflows","count":14},{"language":"default","tag":"Platform","count":10},{"language":"default","tag":"Resource guides","count":8},{"language":"default","tag":"Chat widget","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@keyframes woes-active-nav-enter{0%{background-position:-18px 0;opacity:.72;transform:translateX(-5px)}to{background-position:0 0;opacity:1;transform:translateX(0)}}:root{--woes-orange:#ff7038;--woes-orange-strong:#b83a12;--woes-accent-text:#b83a12;--woes-orange-soft:rgba(255, 112, 56, 0.1);--woes-border:rgba(255, 112, 56, 0.24);--woes-active-bg:rgba(184, 58, 18, 0.08);--woes-active-border:rgba(184, 58, 18, 0.22);--woes-active-text:#5f210f;--woes-active-outline:rgba(255, 112, 56, 0.9);--woes-active-ring:rgba(184, 58, 18, 0.08);--woes-title:#2a211d;--woes-copy:#514842;--woes-copy-muted:#746961;--woes-link:#b83a12;--woes-link-hover:#8f2d0d}html.dark{--woes-accent-text:#ff7038;--woes-active-bg:rgba(255, 255, 255, 0.055);--woes-active-border:rgba(255, 255, 255, 0.07);--woes-active-text:#fff0e8;--woes-active-outline:rgba(255, 112, 56, 0.9);--woes-active-ring:rgba(255, 255, 255, 0.035);--woes-title:#f7f1ea;--woes-copy:#b7aea7;--woes-copy-muted:#8f8780;--woes-link:#ff9a70;--woes-link-hover:#ffc2a5}@view-transition{navigation:auto}.sidebar-group-header,:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"], [class*=\"toc\"]) [class*=uppercase],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"], [class*=\"toc\"]) p[class*=uppercase],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"], [class*=\"toc\"]) span[class*=uppercase]{color:var(--woes-accent-text)!important;font-weight:700!important;letter-spacing:.18em!important;text-transform:uppercase!important}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"])[aria-expanded],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"])[aria-haspopup],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) [data-state]>button{color:var(--woes-accent-text)!important;font-weight:650!important}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"])[aria-expanded] :where(span, svg),:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"])[aria-haspopup] :where(span, svg){color:inherit!important;stroke:currentColor!important}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"])[aria-expanded=false]{opacity:.92}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a[aria-current=page],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a[data-active=true]{color:var(--woes-active-text)!important;font-weight:700!important}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a[aria-current=page]{background:linear-gradient(90deg,rgba(255,112,56,.16),transparent 42%),var(--woes-active-bg)!important;border-color:var(--woes-active-border)!important;box-shadow:inset 3px 0 0 var(--woes-active-outline),inset 0 0 0 1px var(--woes-active-ring)!important;text-shadow:none!important}main h1,main h2,main h3{color:var(--woes-title)!important}main :where(p, li, td, dd, blockquote, figcaption){color:var(--woes-copy)!important}main :where(p, li, td, dd) :where(span, strong){color:inherit!important}main :where(a){color:var(--woes-link)!important;text-decoration-color:rgba(255,112,56,.55)!important;text-underline-offset:.18em}main :where(a:hover){color:var(--woes-link-hover)!important;text-decoration-color:var(--woes-orange)!important}html.dark main :where(table){border-color:rgba(255,255,255,.1)}main :where(th){color:var(--woes-title)!important}main :where(.steps, [class*=\"step\"]) :where(p, div, span):not(a):not(button){color:var(--woes-copy)}.card,[class*=card]{border-color:var(--woes-border)}html.dark main :where(.card, [class*=\"card\"]) :where(p, span, div):not(a):not(button),html:not(.dark) main :where(.card, [class*=\"card\"]) :where(p, span, div):not(a):not(button){color:var(--woes-copy-muted)}html:not(.dark) main :where(\n h1,\n h2,\n h3,\n h4,\n p,\n li,\n td,\n th,\n dd,\n blockquote,\n figcaption\n )[class*=text-neutral-50],html:not(.dark) main :where(\n h1,\n h2,\n h3,\n h4,\n p,\n li,\n td,\n th,\n dd,\n blockquote,\n figcaption\n )[class*=text-slate-50],html:not(.dark) main :where(\n h1,\n h2,\n h3,\n h4,\n p,\n li,\n td,\n th,\n dd,\n blockquote,\n figcaption\n )[class*=text-white],html:not(.dark) main :where(\n h1,\n h2,\n h3,\n h4,\n p,\n li,\n td,\n th,\n dd,\n blockquote,\n figcaption\n )[class*=text-zinc-50],html:not(.dark) main :where(h1, h2, h3, h4, p, li, td, th, dd, blockquote, figcaption) :where(\n [class*=\"text-white\"],\n [class*=\"text-slate-50\"],\n [class*=\"text-zinc-50\"],\n [class*=\"text-neutral-50\"]\n ){color:var(--woes-title)!important}code{border-color:rgba(255,112,56,.18)}.woes-agent-prompt-copy{align-items:center;background:var(--woes-orange);border:1px solid rgba(255,112,56,.72);border-radius:8px;color:#171310;cursor:pointer;display:inline-flex;font-size:.94rem;font-weight:750;gap:.5rem;line-height:1;margin:.75rem 0 1rem;padding:.85rem 1rem;transition:background-color 160ms ease,border-color 160ms ease,transform 160ms ease}.woes-agent-prompt-copy:hover{background:#ff875c;border-color:#ffb08f;transform:translateY(-1px)}.woes-agent-prompt-source{height:1px;left:-9999px;opacity:0;pointer-events:none;position:absolute;top:auto;width:1px}@media (prefers-reduced-motion:no-preference){::view-transition-new(root),::view-transition-old(root){animation-duration:180ms;animation-timing-function:cubic-bezier(.2,.7,.2,1)}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) :where(button, [role=\"button\"]),:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a{transition:background-color 220ms cubic-bezier(.2,.7,.2,1),border-color 220ms cubic-bezier(.2,.7,.2,1),color 220ms cubic-bezier(.2,.7,.2,1),box-shadow 220ms cubic-bezier(.2,.7,.2,1),opacity 220ms cubic-bezier(.2,.7,.2,1),transform 220ms cubic-bezier(.2,.7,.2,1)}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a:hover{transform:translateX(2px)}:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a[aria-current=page],:where(aside, nav, [role=\"navigation\"], [class*=\"sidebar\"]) a[data-active=true]{animation:woes-active-nav-enter 260ms cubic-bezier(.16,1,.3,1);transform:translateX(0)}}"}],"page":{"pagePath":"api-reference/clients/create-client","slug":"/api-reference/clients/create-client","pageMetadata":{"title":"Create client","description":"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/clients","href":"/api-reference/clients/create-client","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\"\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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Create client","description":"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/clients","href":"/api-reference/clients/create-client","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/woes/03c522a7be79c968/woes-widget.js"],"openApiReferenceData":{"operation":{"tags":["Clients"],"operationId":"createClient","summary":"Create client","description":"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.","requestBody":"c4793fcb-6406-4cf7-8187-8d8455efd08a","responses":{"201":"3746b827-ca64-4727-8170-229e6c283d4b","400":"9603ba2d-1bcf-433e-99d8-ced9356c6783","401":"2737fb1c-082a-45e3-950a-ff91b6a19644","403":"59c9199d-215e-45cf-82a5-8aac75b778ad","429":"d6338cf8-e22b-4294-aafb-8bf122ecbaaf","500":"0b412064-e4b1-400f-ac71-8010b41630f7"},"method":"post","type":"path","servers":["d92184bc-4b8a-43b8-9fce-cee7e9e69d6f"],"security":["92b8eb3e-39e3-4c70-b175-56c38cc5a700"],"path":"/api/v1/clients","baseUrlOptions":["https://woes.dev"],"title":"Create client","codeSamples":[],"requestExampleLanguages":["bash","node","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.company":"Example API Co","body.contactName":"Ada Lovelace","body.contactEmail":"ada@example.com","body.notes":"Created from billing CRM sync."}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["company"],"properties":{"company":{"type":"string","minLength":1,"maxLength":120,"isRequired":true,"uniqueKey":"company","typeLabel":"string"},"contactName":{"type":"string","maxLength":120,"uniqueKey":"contactName","typeLabel":"string"},"contactEmail":{"type":"string","format":"email","maxLength":254,"uniqueKey":"contactEmail","typeLabel":"string\u003cemail>"},"notes":{"type":"string","maxLength":500,"uniqueKey":"notes","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"example":{"company":"Example API Co","contactName":"Ada Lovelace","contactEmail":"ada@example.com","notes":"Created from billing CRM sync."},"examples":{"Example":{"title":"Example","value":{"company":"Example API Co","contactName":"Ada Lovelace","contactEmail":"ada@example.com","notes":"Created from billing CRM sync."}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"3746b827-ca64-4727-8170-229e6c283d4b":{"description":"Client seed created.","content":{"application/json":{"schema":{"type":"object","properties":{"client":{"oneOf":[{"type":"object","required":["object","id","name","health","healthScore","metrics","channels","contacts","recentConversations","tasks","firstContactAt","lastMessageAt","latestConversationId"],"properties":{"object":{"type":"string","const":"client","isRequired":true,"uniqueKey":"client.oneOf.0.object","typeLabel":"string"},"id":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.name","typeLabel":"string"},"health":{"type":"string","enum":["attention","healthy","watch"],"isRequired":true,"uniqueKey":"client.oneOf.0.health","typeLabel":"enum\u003cstring>"},"healthScore":{"type":"object","additionalProperties":false,"required":["label","score","activity","conversations","resolutions","reasons"],"properties":{"label":{"type":"string","enum":["attention","healthy","watch"],"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.label","typeLabel":"enum\u003cstring>"},"score":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.score","typeLabel":"integer"},"activity":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.activity","typeLabel":"integer"},"conversations":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.conversations","typeLabel":"integer"},"resolutions":{"type":"integer","minimum":0,"maximum":100,"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.resolutions","typeLabel":"integer"},"reasons":{"type":"array","items":{"type":"string","uniqueKey":"client.oneOf.0.healthScore.reasons.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore.reasons","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"client.oneOf.0.healthScore","typeLabel":"object"},"metrics":{"type":"object","additionalProperties":false,"required":["conversations","openConversations","messages","verifiedContacts","visits"],"properties":{"conversations":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.metrics.conversations","typeLabel":"integer"},"openConversations":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.metrics.openConversations","typeLabel":"integer"},"messages":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.metrics.messages","typeLabel":"integer"},"verifiedContacts":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.metrics.verifiedContacts","typeLabel":"integer"},"visits":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.metrics.visits","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"client.oneOf.0.metrics","typeLabel":"object"},"channels":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["channel","count"],"properties":{"channel":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.channels.items.[INDEX].channel","typeLabel":"string"},"count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.channels.items.[INDEX].count","typeLabel":"integer"}},"uniqueKey":"client.oneOf.0.channels.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"client.oneOf.0.channels","typeLabel":"object[]"},"contacts":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","email","identitySource","lastMessageAt","online","visits"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].name","typeLabel":"string"},"email":{"oneOf":[{"type":"string","format":"email","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].email","typeLabel":"string\u003cemail> | null"},"identitySource":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].identitySource","typeLabel":"string"},"lastMessageAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].lastMessageAt","typeLabel":"string\u003cdate-time>"},"online":{"type":"boolean","isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].online","typeLabel":"boolean"},"visits":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"client.oneOf.0.contacts.items.[INDEX].visits","typeLabel":"integer"}},"uniqueKey":"client.oneOf.0.contacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"client.oneOf.0.contacts","typeLabel":"object[]"},"recentConversations":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","channel","subject","preview","status","lastMessageAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].id","typeLabel":"string"},"channel":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].channel","typeLabel":"string"},"subject":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].subject","typeLabel":"string"},"preview":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].preview","typeLabel":"string"},"status":{"type":"string","enum":["open","waiting","solved"],"isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"lastMessageAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX].lastMessageAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"client.oneOf.0.recentConversations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"client.oneOf.0.recentConversations","typeLabel":"object[]"},"tasks":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","subject","preview","status","priority","lastMessageAt"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].id","typeLabel":"string"},"subject":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].subject","typeLabel":"string"},"preview":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].preview","typeLabel":"string"},"status":{"type":"string","enum":["open","waiting","solved"],"isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"priority":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].priority","typeLabel":"string"},"lastMessageAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"client.oneOf.0.tasks.items.[INDEX].lastMessageAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"client.oneOf.0.tasks.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"client.oneOf.0.tasks","typeLabel":"object[]"},"firstContactAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"client.oneOf.0.firstContactAt","typeLabel":"string\u003cdate-time>"},"lastMessageAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"client.oneOf.0.lastMessageAt","typeLabel":"string\u003cdate-time>"},"latestConversationId":{"type":"string","isRequired":true,"uniqueKey":"client.oneOf.0.latestConversationId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"client.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"client.oneOf.1","typeLabel":"null"}],"uniqueKey":"client","typeLabel":"object | null"},"truncated":{"type":"boolean","uniqueKey":"truncated","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"client":{"object":"client","id":"\u003cstring>","name":"\u003cstring>","health":"attention","healthScore":{"label":"attention","score":50,"activity":50,"conversations":50,"resolutions":50,"reasons":["\u003cstring>"]},"metrics":{"conversations":1,"openConversations":1,"messages":1,"verifiedContacts":1,"visits":1},"channels":[{"channel":"\u003cstring>","count":1}],"contacts":[{"id":"\u003cstring>","name":"\u003cstring>","email":"jsmith@example.com","identitySource":"\u003cstring>","lastMessageAt":"2023-11-07T05:31:56Z","online":true,"visits":1}],"recentConversations":[{"id":"\u003cstring>","channel":"\u003cstring>","subject":"\u003cstring>","preview":"\u003cstring>","status":"open","lastMessageAt":"2023-11-07T05:31:56Z"}],"tasks":[{"id":"\u003cstring>","subject":"\u003cstring>","preview":"\u003cstring>","status":"open","priority":"\u003cstring>","lastMessageAt":"2023-11-07T05:31:56Z"}],"firstContactAt":"2023-11-07T05:31:56Z","lastMessageAt":"2023-11-07T05:31:56Z","latestConversationId":"\u003cstring>"},"truncated":true}}},"exampleType":"generated"}},"exampleType":"generated"},"9603ba2d-1bcf-433e-99d8-ced9356c6783":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","error"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"invalidRequest":{"title":"invalidRequest","value":{"code":"invalid_request","error":"Request body is invalid."}}},"exampleType":"examples"}},"exampleType":"examples"},"2737fb1c-082a-45e3-950a-ff91b6a19644":{"description":"Missing, unknown, revoked, or expired API key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","error"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unauthorized":{"title":"unauthorized","value":{"code":"unauthorized","error":"A valid workspace API key is required."}}},"exampleType":"examples"}},"exampleType":"examples"},"59c9199d-215e-45cf-82a5-8aac75b778ad":{"description":"API key does not include the required scope.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","error"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficientScope":{"title":"insufficientScope","value":{"code":"insufficient_scope","error":"This API key is missing the required scope."}}},"exampleType":"examples"}},"exampleType":"examples"},"d6338cf8-e22b-4294-aafb-8bf122ecbaaf":{"description":"Too many API requests.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","error"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"rateLimited":{"title":"rateLimited","value":{"code":"rate_limited","error":"Too many API requests. Slow down and try again shortly."}}},"exampleType":"examples"}},"exampleType":"examples"},"0b412064-e4b1-400f-ac71-8010b41630f7":{"description":"Unexpected API failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["code","error"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"internalError":{"title":"internalError","value":{"code":"internal_error","error":"The API request could not be completed."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"92b8eb3e-39e3-4c70-b175-56c38cc5a700":{"workspaceApiKey":{"type":"http","scheme":"bearer","description":"Workspace API key that starts with woesk_. Paste your own key into the docs playground; never expose it in browser code.","x-default":"woesk_your_api_key_here","scopes":[]}}},"servers":{"d92184bc-4b8a-43b8-9fce-cee7e9e69d6f":{"url":"https://woes.dev","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace API key that starts with woesk_. Paste your own key into the docs playground; never expose it in browser code.","x-default":"woesk_your_api_key_here","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key that starts with woesk_. Paste your own key into the docs playground; never expose it in browser code.","format":"bearer","default":"woesk_your_api_key_here","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"workspaceApiKey","name":"Authorization"}],"title":"workspaceApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"woes","siteName":"Woes","title":"Create client - Woes","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-04T16:34:53.269Z","originalFileLocation":"api-reference/clients/create-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 manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Woes\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_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/woes/SSvjR3VTqRe-th0R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create client - Woes\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Woes Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.woes.dev/api-reference/clients/create-client\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://woes.mintlify.app/_mintlify/api/og/v2?division=Clients\u0026amp;title=Create+client\u0026amp;description=Creates+a+manual+client%2Faccount+seed+in+the+authenticated+workspace.+The+client+is+represented+by+an+API-origin+support+conversation+and+then+returned+through+t\u0026amp;theme=594accbaf32d79441de8f280\u0026amp;signature=d7f69a64696adee424d7c79f6a6c33ace1333cb84e5b1b64bb7e6b824de16c39\">\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 client - Woes\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://woes.mintlify.app/_mintlify/api/og/v2?division=Clients\u0026amp;title=Create+client\u0026amp;description=Creates+a+manual+client%2Faccount+seed+in+the+authenticated+workspace.+The+client+is+represented+by+an+API-origin+support+conversation+and+then+returned+through+t\u0026amp;theme=594accbaf32d79441de8f280\u0026amp;signature=d7f69a64696adee424d7c79f6a6c33ace1333cb84e5b1b64bb7e6b824de16c39\">\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/woes/SSvjR3VTqRe-th0R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Woes\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#B83A12\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.woes.dev/api-reference/clients/create-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/clients/create-client.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.woes.dev/#organization\",\"name\":\"Woes\",\"url\":\"https://docs.woes.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/woes/QdK5garcQwoPsAlm/images/woes-wordmark.png?fit=max\u0026auto=format\u0026n=QdK5garcQwoPsAlm\u0026q=85\u0026s=5fb012a2064e1898482aab3a15aa40fc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.woes.dev#website\",\"name\":\"Woes\",\"url\":\"https://docs.woes.dev\",\"publisher\":{\"@id\":\"https://docs.woes.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.woes.dev/api-reference/clients/create-client#webpage\",\"url\":\"https://docs.woes.dev/api-reference/clients/create-client\",\"name\":\"Create client\",\"description\":\"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\",\"dateModified\":\"2026-07-04T16:34:53.269Z\",\"isPartOf\":{\"@id\":\"https://docs.woes.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.woes.dev/api-reference/clients/create-client#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.woes.dev/api-reference/clients/create-client#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.woes.dev/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Endpoint reference\",\"item\":\"https://docs.woes.dev/api-reference/conversations/list-conversations\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Clients\",\"item\":\"https://docs.woes.dev/api-reference/clients/list-clients\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Create client\",\"item\":\"https://docs.woes.dev/api-reference/clients/create-client\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.woes.dev/api-reference/clients/create-client#apireference\",\"headline\":\"Create client\",\"name\":\"Create client\",\"description\":\"Creates a manual client/account seed in the authenticated workspace. The client is represented by an API-origin support conversation and then returned through the same client aggregate used by the Clients page.\",\"url\":\"https://docs.woes.dev/api-reference/clients/create-client\",\"mainEntityOfPage\":{\"@id\":\"https://docs.woes.dev/api-reference/clients/create-client#webpage\"},\"dateModified\":\"2026-07-04T16:34:53.269Z\",\"publisher\":{\"@id\":\"https://docs.woes.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.woes.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Woes\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Woes","nav":{"global":null,"tabs":[{"tab":"Docs","icon":"book-open","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"API reference","pages":[{"group":"Start here","expanded":false,"pages":[{"title":"API Reference","sidebarTitle":"Start here","href":"/api-reference/overview"},{"title":"REST API Overview","sidebarTitle":"REST API guide","href":"/api/overview"},{"title":"Authentication","href":"/api/authentication"},{"title":"API Keys","href":"/api/keys"}]},{"group":"Runtime guides","expanded":false,"pages":[{"title":"Route Map","sidebarTitle":"Route map","href":"/reference/routes"},{"title":"MCP Server","sidebarTitle":"MCP Server","icon":"plug-zap","href":"/api/mcp"},{"title":"Widget Runtime","href":"/api/widget"},{"title":"Widget Routes","sidebarTitle":"Widget routes","href":"/api/widget-routes"},{"title":"Survey Delivery","href":"/api/surveys"}]},{"group":"Resource guides","expanded":false,"pages":[{"title":"Conversations","sidebarTitle":"Conversations API","href":"/api/conversations"},{"title":"Issues","sidebarTitle":"Issues API","href":"/api/issues"},{"title":"Clients","sidebarTitle":"Clients API","href":"/api/clients"},{"title":"Agents","sidebarTitle":"Agents API","href":"/api/agents"},{"title":"Sources","sidebarTitle":"Sources API","href":"/api/sources"},{"title":"Definitions","sidebarTitle":"Definitions API","href":"/api/definitions"},{"title":"Usage","sidebarTitle":"Usage API","href":"/api/usage"},{"title":"Analytics","sidebarTitle":"Analytics API","href":"/api/analytics"}]},{"group":"Endpoint reference","expanded":false,"pages":[{"group":"Conversations","expanded":false,"pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/conversations","href":"/api-reference/conversations/list-conversations"},{"title":"Create conversation","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/conversations","href":"/api-reference/conversations/create-conversation"},{"title":"Retrieve conversation","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/conversations/{conversationId}","href":"/api-reference/conversations/retrieve-conversation"},{"title":"Update conversation","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/conversations/{conversationId}","href":"/api-reference/conversations/update-conversation"},{"title":"List messages","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/conversations/{conversationId}/messages","href":"/api-reference/conversations/list-messages"},{"title":"Create message","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/conversations/{conversationId}/messages","href":"/api-reference/conversations/create-message"}]},{"group":"Issues","expanded":false,"pages":[{"title":"List issues","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/issues","href":"/api-reference/issues/list-issues"},{"title":"Create issue","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/issues","href":"/api-reference/issues/create-issue"},{"title":"Retrieve issue","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/issues/{issueId}","href":"/api-reference/issues/retrieve-issue"},{"title":"Update issue","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/issues/{issueId}","href":"/api-reference/issues/update-issue"}]},{"group":"Clients","expanded":false,"pages":[{"title":"List clients","description":"Lists client account aggregates derived from conversations in the API key workspace.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/clients","href":"/api-reference/clients/list-clients"},{"title":"Create client","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/clients","href":"/api-reference/clients/create-client"},{"title":"Retrieve client","description":"Retrieves one client account aggregate from the API key workspace. Missing or cross-workspace ids return 404.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/clients/{clientId}","href":"/api-reference/clients/retrieve-client"}]},{"group":"Agents","expanded":false,"pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Retrieve agent","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agentId}","href":"/api-reference/agents/retrieve-agent"}]},{"group":"Sources","expanded":false,"pages":[{"title":"List sources","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/sources","href":"/api-reference/sources/list-sources"},{"title":"Create source","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/sources","href":"/api-reference/sources/create-source"},{"title":"Retrieve source","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/sources/{sourceId}","href":"/api-reference/sources/retrieve-source"},{"title":"Update source","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/sources/{sourceId}","href":"/api-reference/sources/update-source"},{"title":"Delete source","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/sources/{sourceId}","href":"/api-reference/sources/delete-source"},{"title":"Rescan source","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/sources/{sourceId}/rescan","href":"/api-reference/sources/rescan-source"}]},{"group":"Definitions","expanded":false,"pages":[{"title":"List tags","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/tags","href":"/api-reference/definitions/list-tags"},{"title":"List statuses","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/statuses","href":"/api-reference/definitions/list-statuses"},{"title":"List priorities","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/priorities","href":"/api-reference/definitions/list-priorities"},{"title":"List custom fields","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/custom-fields","href":"/api-reference/definitions/list-custom-fields"}]},{"group":"Usage","expanded":false,"pages":[{"title":"Retrieve usage","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/usage","href":"/api-reference/usage/retrieve-usage"},{"title":"List API key usage","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/usage/api-keys","href":"/api-reference/usage/list-api-key-usage"}]},{"group":"Analytics","expanded":false,"pages":[{"title":"Retrieve analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics","href":"/api-reference/analytics/retrieve-analytics"}]}]}]}]},{"tab":"Integrations","icon":"plug-zap","pages":[{"title":"Integrations","href":"/integrations-catalog/overview"}]}]},"title":"Create client - Woes","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}