At least one of phone_number or email is required. A contact that
already exists with the same phone number is rejected with
DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dialtu","description":"Documentación de Dialtu, la plataforma de automatización comercial con IA: guías de producto y referencia de la API pública","colors":{"primary":"#6633FF","light":"#9966FF","dark":"#5229CC"},"logo":{"light":"https://mintcdn.com/dialtu-0be120d3/TUPVgXHfXGujXaJe/logo/light.svg?fit=max\u0026auto=format\u0026n=TUPVgXHfXGujXaJe\u0026q=85\u0026s=d6c7d6e992583a882baffad77a34e714","dark":"https://mintcdn.com/dialtu-0be120d3/TUPVgXHfXGujXaJe/logo/dark.svg?fit=max\u0026auto=format\u0026n=TUPVgXHfXGujXaJe\u0026q=85\u0026s=53346d8a0b194cd0f5570ab69399758e","href":"https://www.dialtu.com"},"favicon":"https://mintcdn.com/dialtu-0be120d3/TUPVgXHfXGujXaJe/favicon.svg?fit=max\u0026auto=format\u0026n=TUPVgXHfXGujXaJe\u0026q=85\u0026s=0315cca2c3d3b259239699a32b2ba0c2","api":{"openapi":"https://api.dialtu.com/api/v2/public/openapi.json","params":{"expanded":"closed"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"primary":{"type":"button","label":"Ir al panel","href":"https://app.dialtu.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/dialtu"}},"seo":{"metatags":{"og:site_name":"Dialtu Documentation","og:type":"website","twitter:card":"summary_large_image"},"indexing":"navigable"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"es","href":"es/getting-started/what-is-dialtu"},{"language":"en","href":"en/getting-started/what-is-dialtu"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dialtu-0be120d3","hasAudioNarration":false,"actualSubdomain":"dialtu-0be120d3","customDomains":["docs.dialtu.com"],"gitSource":{"type":"github","owner":"davidbo99","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad1c47d4608008ddf98398c","collectionId":"c9ae7c78-1224-4dac-bb8d-c887c34731cc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad1c47d4608008ddf98398c"},"feedback":{"edits":false,"issues":false},"entitlements":{},"buildId":"6ad1c47d4608008ddf98398c","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"en","tag":"Guides","count":80},{"language":"es","tag":"Guías","count":80},{"language":"en","tag":"API Reference","count":27},{"language":"es","tag":"Referencia de API","count":27},{"language":"en","tag":"Calendar","count":23},{"language":"en","tag":"Endpoints","count":21},{"language":"es","tag":"Endpoints","count":21},{"language":"es","tag":"Calendario","count":15},{"language":"en","tag":"Salesflow","count":12},{"language":"en","tag":"WhatsApp agents","count":12},{"language":"es","tag":"Salesflow","count":12},{"language":"es","tag":"Agentes de WhatsApp","count":12},{"language":"en","tag":"SMS agents","count":11},{"language":"es","tag":"Agentes de SMS","count":11},{"language":"en","tag":"Organizations","count":9},{"language":"es","tag":"Organizaciones","count":9},{"language":"es","tag":"Calendar","count":8},{"language":"en","tag":"Getting started","count":7},{"language":"en","tag":"Salesflow pipelines","count":7},{"language":"es","tag":"Salesflow pipelines","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"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":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/endpoints/clients/create-a-client","slug":"/en/api-reference/endpoints/clients/create-a-client","pageMetadata":{"title":"Create a client","openapi":"POST /api/v2/public/clients","description":"Create a contact in your account.\n\nAt least one of `phone_number` or `email` is required. A contact that\nalready exists with the same phone number is rejected with\n`DUPLICATE_CLIENT`. Tags are created on the fly when they do not exist yet.","href":"/en/api-reference/endpoints/clients/create-a-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: [_jsx(_components.p, {\n children: \"Create a contact in your account.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"At least one of \", _jsx(_components.code, {\n children: \"phone_number\"\n }), \" or \", _jsx(_components.code, {\n children: \"email\"\n }), \" is required. A contact that\\nalready exists with the same phone number is rejected with\\n\", _jsx(_components.code, {\n children: \"DUPLICATE_CLIENT\"\n }), \". Tags are created on the fly when they do not exist yet.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a client","openapi":"POST /api/v2/public/clients","description":"Create a contact in your account.\n\nAt least one of `phone_number` or `email` is required. A contact that\nalready exists with the same phone number is rejected with\n`DUPLICATE_CLIENT`. Tags are created on the fly when they do not exist yet.","href":"/en/api-reference/endpoints/clients/create-a-client"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createClient","summary":"Create a client","parameters":[],"responses":{"201":"971a7268-1da4-4556-aa1c-7bed8a664b43","400":"0fa9c170-2068-4dbe-8f95-ec401b947312","401":"59788854-4d3d-4752-aa73-9e1854c25e57","422":"f196208b-c0ad-495e-8a98-bbd73a9ab036","500":"09952f45-f782-4ef5-9e1c-d0b58d9c54d6"},"description":"Create a contact in your account.\n\nAt least one of `phone_number` or `email` is required. A contact that\nalready exists with the same phone number is rejected with\n`DUPLICATE_CLIENT`. Tags are created on the fly when they do not exist yet.","tags":["Clients"],"requestBody":"a14a87cd-66f1-4df7-bc7f-6ce7003f7c38","security":["03e12e62-7af2-4902-998a-1cae04eb3004"],"method":"post","type":"path","servers":["64986e62-6aff-4026-a2be-2361e00f4585","b407c61f-7c82-415e-85d4-7a1b8f2be716"],"path":"/api/v2/public/clients","baseUrlOptions":["https://api.dialtu.com","https://api.stg.dialtu.com"],"title":"Create a client","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"description":"Public API request schema for creating a client.","examples":[{"company":"Acme","data":{"source":"website"},"email":"ana@example.com","first_name":"Ana","identity_document_number":"1020304050","identity_document_type":"CC","last_name":"García","phone_number":"+525512345678","tags":[{"color":"#7B61FF","name":"lead"}],"timezone":"America/Mexico_City"}],"properties":{"first_name":{"oneOf":[{"type":"string","title":"First Name","description":"Given name.","uniqueKey":"first_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"First Name","description":"Given name.","uniqueKey":"first_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"first_name","typeLabel":"string | null"},"last_name":{"oneOf":[{"type":"string","title":"Last Name","description":"Family name.","uniqueKey":"last_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Name","description":"Family name.","uniqueKey":"last_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_name","typeLabel":"string | null"},"area_code":{"oneOf":[{"type":"string","title":"Area Code","description":"Country calling code (for example `52`) stored alongside the phone number. Optional when `phone_number` is already in E.164 format.","default":"","uniqueKey":"area_code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Area Code","description":"Country calling code (for example `52`) stored alongside the phone number. Optional when `phone_number` is already in E.164 format.","default":"","uniqueKey":"area_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"area_code","typeLabel":"string | null"},"phone_number":{"oneOf":[{"type":"string","title":"Phone Number","description":"Phone number, preferably E.164 (`+525512345678`). Required unless `email` is provided.","uniqueKey":"phone_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"Phone Number","description":"Phone number, preferably E.164 (`+525512345678`). Required unless `email` is provided.","uniqueKey":"phone_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"phone_number","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","description":"Email address. Required unless `phone_number` is provided.","uniqueKey":"email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","description":"Email address. Required unless `phone_number` is provided.","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string | null"},"company":{"oneOf":[{"type":"string","title":"Company","description":"Company or organization name.","uniqueKey":"company.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company","description":"Company or organization name.","uniqueKey":"company.oneOf.1","typeLabel":"null"}],"uniqueKey":"company","typeLabel":"string | null"},"identity_document_type":{"oneOf":[{"type":"string","title":"Identity Document Type","description":"Kind of identity document: `CC`, `CE`, `NIT`, `TI`, `PA`, `DNI`, `RUT`, `SSN`, `EIN` or `OTHER`.","enum":["CC","CE","NIT","TI","PA","DNI","RUT","SSN","EIN","OTHER"],"uniqueKey":"identity_document_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Identity Document Type","description":"Kind of identity document: `CC`, `CE`, `NIT`, `TI`, `PA`, `DNI`, `RUT`, `SSN`, `EIN` or `OTHER`.","uniqueKey":"identity_document_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"identity_document_type","typeLabel":"enum\u003cstring> | null"},"identity_document_number":{"oneOf":[{"type":"string","title":"Identity Document Number","description":"Identity document number (e.g. the cédula).","maxLength":64,"uniqueKey":"identity_document_number.oneOf.0","typeLabel":"string"},{"type":"null","title":"Identity Document Number","description":"Identity document number (e.g. the cédula).","uniqueKey":"identity_document_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"identity_document_number","typeLabel":"string | null"},"timezone":{"default":"UTC","description":"IANA timezone of the contact (for example `America/Bogota`).","title":"Timezone","type":"string","uniqueKey":"timezone","typeLabel":"string"},"data":{"oneOf":[{"type":"object","title":"Data","description":"Free-form custom fields stored on the contact and available to agents as prompt variables.","additionalProperties":true,"uniqueKey":"data.oneOf.0","typeLabel":"Data · object"},{"type":"null","title":"Data","description":"Free-form custom fields stored on the contact and available to agents as prompt variables.","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"Data · object | null"},"tags":{"oneOf":[{"type":"array","items":{"description":"Tag info for public API.","properties":{"name":{"description":"Tag name; matched case-sensitively against existing tags.","title":"Name","type":"string","isRequired":true,"uniqueKey":"tags.oneOf.0.items.[INDEX].name","typeLabel":"string"},"color":{"description":"Hex color used when the tag has to be created, e.g. `#7B61FF`.","title":"Color","type":"string","isRequired":true,"uniqueKey":"tags.oneOf.0.items.[INDEX].color","typeLabel":"string"},"description":{"oneOf":[{"type":"string","title":"Description","description":"Optional description shown in the dashboard.","uniqueKey":"tags.oneOf.0.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"Optional description shown in the dashboard.","uniqueKey":"tags.oneOf.0.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"tags.oneOf.0.items.[INDEX].description","typeLabel":"string | null"}},"required":["name","color"],"title":"PublicTagSchema","type":"object","uniqueKey":"tags.oneOf.0.items.[INDEX]","typeLabel":"PublicTagSchema · object"},"title":"Tags","description":"Tags to attach. Tags that do not exist yet are created.","uniqueKey":"tags.oneOf.0","typeLabel":"PublicTagSchema · object[]"},{"type":"null","title":"Tags","description":"Tags to attach. Tags that do not exist yet are created.","uniqueKey":"tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"tags","typeLabel":"PublicTagSchema · object[] | null"}},"title":"PublicCreateClientSchema","type":"object","uniqueKey":"","typeLabel":"PublicCreateClientSchema · object"},"examples":{"Example":{"title":"Example","value":{"company":"Acme","data":{"source":"website"},"email":"ana@example.com","first_name":"Ana","identity_document_number":"1020304050","identity_document_type":"CC","last_name":"García","phone_number":"+525512345678","tags":[{"color":"#7B61FF","name":"lead"}],"timezone":"America/Mexico_City"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"971a7268-1da4-4556-aa1c-7bed8a664b43":{"description":"Created","content":{"application/json":{"schema":{"description":"Public API response schema for created client.","properties":{"status":{"const":"success","description":"Response status","title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"client_id":{"description":"Unique identifier for the created client","title":"Client Id","type":"integer","isRequired":true,"uniqueKey":"client_id","typeLabel":"integer"},"message":{"description":"Human-readable success message","title":"Message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["status","client_id","message"],"title":"PublicClientResponse","type":"object","uniqueKey":"","typeLabel":"PublicClientResponse · object"},"examples":{"Example":{"title":"Example","value":{"status":"success","client_id":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"0fa9c170-2068-4dbe-8f95-ec401b947312":{"description":"Bad Request","content":{"application/json":{"schema":{"description":"Public API error response for client operations.","properties":{"status":{"const":"error","description":"Error status","title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"error_code":{"description":"Machine-readable error code","title":"Error Code","type":"string","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"message":{"description":"Human-readable error message","title":"Message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","description":"Additional error details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"required":["status","error_code","message"],"title":"PublicClientErrorResponse","type":"object","uniqueKey":"","typeLabel":"PublicClientErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"status":"error","error_code":"\u003cstring>","message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"59788854-4d3d-4752-aa73-9e1854c25e57":{"description":"Missing, malformed or revoked API key.","content":{"application/json":{"schema":{"description":"Plain error body: `{\"detail\": \"...\"}`. No `error_code` is included.","properties":{"detail":{"description":"Human-readable reason for the failure.","title":"Detail","type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"required":["detail"],"title":"DetailErrorResponse","type":"object","uniqueKey":"","typeLabel":"DetailErrorResponse · object"},"examples":{"missing_header":{"title":"missing_header","value":{"detail":"Unauthorized"}},"invalid_key":{"title":"invalid_key","value":{"detail":"Invalid or expired API key. Please check your credentials."}}},"exampleType":"examples"}},"exampleType":"examples"},"f196208b-c0ad-495e-8a98-bbd73a9ab036":{"description":"The request did not match the documented schema.","content":{"application/json":{"schema":{"title":"RequestValidationError","type":"object","description":"Returned when the request body, query string or path could not be parsed against the documented schema. Fix the listed fields and retry.","properties":{"detail":{"type":"array","title":"Detail","description":"One entry per invalid field.","items":{"title":"RequestValidationErrorItem","type":"object","properties":{"loc":{"type":"array","title":"Loc","description":"Where the problem is: the first element is `body`, `query` or `path`, followed by the field path.","items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Msg","description":"What is wrong with the value.","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Type","description":"Machine-readable validation error type, e.g. `missing` or `int_parsing`.","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"required":["loc","msg","type"],"uniqueKey":"detail.items.[INDEX]","typeLabel":"RequestValidationErrorItem · object"},"isRequired":true,"uniqueKey":"detail","typeLabel":"RequestValidationErrorItem · object[]"}},"required":["detail"],"uniqueKey":"","typeLabel":"RequestValidationError · object"},"example":{"detail":[{"type":"missing","loc":["body","payload","phone_number"],"msg":"Field required"}]},"examples":{"Example":{"title":"Example","value":{"detail":[{"type":"missing","loc":["body","payload","phone_number"],"msg":"Field required"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"09952f45-f782-4ef5-9e1c-d0b58d9c54d6":{"description":"Internal Server Error","content":{"application/json":{"schema":{"description":"Public API error response for client operations.","properties":{"status":{"const":"error","description":"Error status","title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"error_code":{"description":"Machine-readable error code","title":"Error Code","type":"string","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"message":{"description":"Human-readable error message","title":"Message","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","description":"Additional error details","additionalProperties":true,"uniqueKey":"details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","description":"Additional error details","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"Details · object | null"}},"required":["status","error_code","message"],"title":"PublicClientErrorResponse","type":"object","uniqueKey":"","typeLabel":"PublicClientErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"status":"error","error_code":"\u003cstring>","message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"03e12e62-7af2-4902-998a-1cae04eb3004":{"ApiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"pk_...","description":"API key created in the dashboard under **Settings → API Keys**. Send it as `Authorization: Bearer pk_...`.","scopes":[],"schemeName":"ApiKeyBearer"}}},"servers":{"64986e62-6aff-4026-a2be-2361e00f4585":{"url":"https://api.dialtu.com","description":"Production"},"b407c61f-7c82-415e-85d4-7a1b8f2be716":{"url":"https://api.stg.dialtu.com","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"pk_...","description":"API key created in the dashboard under **Settings → API Keys**. Send it as `Authorization: Bearer pk_...`.","scopes":[],"schemeName":"ApiKeyBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key created in the dashboard under **Settings → API Keys**. Send it as `Authorization: Bearer pk_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyBearer","name":"Authorization"}],"title":"ApiKeyBearer"}]},"originalFileLocation":"https://api.dialtu.com/api/v2/public/openapi.json"},"subdomain":"dialtu-0be120d3","siteName":"Dialtu","title":"Create a client - Dialtu","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/es/api-reference/endpoints/clients/create-a-client","matchLevel":1},"en":{"href":"/en/api-reference/endpoints/clients/create-a-client","matchLevel":0}}},"lastModified":"2026-09-14T17:42:51.071Z","originalFileLocation":"en/api-reference/endpoints/clients/create-a-client.mdx","locale":"en"},"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=\"Create a contact in your account. At least one of phone_number or email is required. A contact that already exists with the same phone number is rejected with DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dialtu\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a client - Dialtu\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a contact in your account. At least one of phone_number or email is required. A contact that already exists with the same phone number is rejected with DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dialtu Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dialtu-0be120d3.mintlify.app/_mintlify/api/og/v2?division=Clients\u0026amp;title=Create+a+client\u0026amp;description=Create+a+contact+in+your+account.%0A%0AAt+least+one+of+%60phone_number%60+or+%60email%60+is+required.+A+contact+that%0Aalready+exists+with+the+same+phone+number+is+rejected+w\u0026amp;theme=2034318531132db55603086e\u0026amp;signature=21cbbcf9bc8cde564925a34f56b77017fc102cd00dc9a0bd4779a25721ad7933\">\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 client - Dialtu\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a contact in your account. At least one of phone_number or email is required. A contact that already exists with the same phone number is rejected with DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dialtu-0be120d3.mintlify.app/_mintlify/api/og/v2?division=Clients\u0026amp;title=Create+a+client\u0026amp;description=Create+a+contact+in+your+account.%0A%0AAt+least+one+of+%60phone_number%60+or+%60email%60+is+required.+A+contact+that%0Aalready+exists+with+the+same+phone+number+is+rejected+w\u0026amp;theme=2034318531132db55603086e\u0026amp;signature=21cbbcf9bc8cde564925a34f56b77017fc102cd00dc9a0bd4779a25721ad7933\">\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/dialtu-0be120d3/zx4Lw4U-4aE1CF7l/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dialtu\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6633FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/endpoints/clients/create-a-client.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.dialtu.com/es/api-reference/endpoints/clients/create-a-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.dialtu.com/es/api-reference/endpoints/clients/create-a-client\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dialtu.com/#organization\",\"name\":\"Dialtu\",\"url\":\"https://docs.dialtu.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dialtu-0be120d3/TUPVgXHfXGujXaJe/logo/light.svg?fit=max\u0026auto=format\u0026n=TUPVgXHfXGujXaJe\u0026q=85\u0026s=d6c7d6e992583a882baffad77a34e714\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dialtu.com#website\",\"name\":\"Dialtu\",\"url\":\"https://docs.dialtu.com\",\"publisher\":{\"@id\":\"https://docs.dialtu.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client#webpage\",\"url\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\",\"name\":\"Create a client\",\"description\":\"Create a contact in your account. At least one of phone_number or email is required. A contact that already exists with the same phone number is rejected with DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.\",\"dateModified\":\"2026-09-14T17:42:51.071Z\",\"isPartOf\":{\"@id\":\"https://docs.dialtu.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.dialtu.com/en/api-reference/endpoints/calls/schedule-a-call\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a client\",\"item\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client#apireference\",\"headline\":\"Create a client\",\"name\":\"Create a client\",\"description\":\"Create a contact in your account. At least one of phone_number or email is required. A contact that already exists with the same phone number is rejected with DUPLICATE_CLIENT. Tags are created on the fly when they do not exist yet.\",\"url\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dialtu.com/en/api-reference/endpoints/clients/create-a-client#webpage\"},\"dateModified\":\"2026-09-14T17:42:51.071Z\",\"publisher\":{\"@id\":\"https://docs.dialtu.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dialtu.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dialtu\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dialtu","nav":{"global":null,"languages":[{"language":"es","pages":[{"title":"es","href":"/es/api-reference/endpoints/clients/create-a-client"}]},{"language":"en","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en/getting-started/what-is-dialtu"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Getting started","icon":"rocket","pages":[{"title":"Introduction","icon":"rocket","href":"/en/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/en/api-reference/authentication"},{"title":"Errors","icon":"triangle-exclamation","href":"/en/api-reference/errors"}]},{"group":"Guides","icon":"book","pages":[{"title":"Sync WhatsApp conversations","icon":"whatsapp","href":"/en/api-reference/guides/whatsapp-conversation-sync"},{"title":"Book calendar appointments","icon":"calendar-check","href":"/en/api-reference/guides/calendar-appointments"},{"title":"Batch ingest clients","icon":"file-import","href":"/en/api-reference/guides/batch-ingest-clients"}]},{"group":"Endpoints","icon":"plug","pages":[{"group":"Calls","pages":[{"title":"Schedule a call","openapi":"POST /api/v2/public/calls/schedule","description":"Queue an outbound AI call to a phone number, either right away or at `start_time`.\n\nThe call is placed by the voice agent identified by `agent_id`; the engine\n(Aurora or Solara) is detected from the agent, so the same request works for\nboth. The response confirms the queued call — the call itself runs\nasynchronously.\n\nPass `client_id` to attach the call to an existing contact, or use\n`request_data` / `dynamic_data` to inject values the agent's prompt refers to.\nRetries on no-answer are configured with the `max_retries` / `retry_*` fields.","href":"/en/api-reference/endpoints/calls/schedule-a-call"}]},{"group":"Clients","pages":[{"title":"Create a client","openapi":"POST /api/v2/public/clients","href":"/en/api-reference/endpoints/clients/create-a-client"}]},{"group":"Salesflow","pages":[{"title":"Ingest a client into a pipeline","openapi":"POST /api/v2/public/salesflow/ingest/{input_node_uuid}","description":"Push a lead into a Salesflow pipeline through one of its API input nodes.\n\nThe client is looked up by `client_id` or `phone_number` and created when\nit does not exist yet; it then enters the stage the input node points to.\nThe input node must be of type **API** and active. Set `update` to refresh\nthe stored contact fields when the client already exists.","href":"/en/api-reference/endpoints/salesflow/ingest-a-client-into-a-pipeline"},{"title":"Batch ingest clients into a pipeline","openapi":"POST /api/v2/public/salesflow/ingest/{input_node_uuid}/batch","href":"/en/api-reference/endpoints/salesflow/batch-ingest-clients-into-a-pipeline"}]},{"group":"Salesflow pipelines","pages":[{"title":"List pipelines","openapi":"GET /api/v2/public/salesflow/pipelines","href":"/en/api-reference/endpoints/salesflow-pipelines/list-pipelines"},{"title":"List API input nodes of a pipeline","openapi":"GET /api/v2/public/salesflow/pipelines/{pipeline_id}/input-nodes","href":"/en/api-reference/endpoints/salesflow-pipelines/list-api-input-nodes-of-a-pipeline"},{"title":"List stages in a pipeline","openapi":"GET /api/v2/public/salesflow/pipelines/{pipeline_id}/stages","href":"/en/api-reference/endpoints/salesflow-pipelines/list-stages-in-a-pipeline"},{"title":"List clients in a pipeline","openapi":"GET /api/v2/public/salesflow/pipelines/{pipeline_id}/clients","href":"/en/api-reference/endpoints/salesflow-pipelines/list-clients-in-a-pipeline"},{"title":"Add clients to a pipeline","openapi":"POST /api/v2/public/salesflow/pipelines/{pipeline_id}/clients/add","href":"/en/api-reference/endpoints/salesflow-pipelines/add-clients-to-a-pipeline"},{"title":"Remove clients from a pipeline","openapi":"POST /api/v2/public/salesflow/pipelines/{pipeline_id}/clients/remove","href":"/en/api-reference/endpoints/salesflow-pipelines/remove-clients-from-a-pipeline"},{"title":"Move a client between stages","openapi":"PATCH /api/v2/public/salesflow/pipelines/{pipeline_id}/clients/{client_id}/move","href":"/en/api-reference/endpoints/salesflow-pipelines/move-a-client-between-stages"}]},{"group":"Calendar","pages":[{"title":"Get bookable capacity per service","openapi":"GET /api/v2/public/calendar/availability","href":"/en/api-reference/endpoints/calendar/get-bookable-capacity-per-service"},{"title":"List bookable services","openapi":"GET /api/v2/public/calendar/services","href":"/en/api-reference/endpoints/calendar/list-bookable-services"},{"title":"Book an appointment","openapi":"POST /api/v2/public/calendar/events","href":"/en/api-reference/endpoints/calendar/book-an-appointment"},{"title":"Add a client to the waiting list","openapi":"POST /api/v2/public/calendar/waitlist/entries","href":"/en/api-reference/endpoints/calendar/add-a-client-to-the-waiting-list"},{"title":"Add many clients to a waiting list","openapi":"POST /api/v2/public/calendar/waitlist/entries/batch","href":"/en/api-reference/endpoints/calendar/add-many-clients-to-a-waiting-list"},{"title":"List waiting-list entries","openapi":"GET /api/v2/public/calendar/waitlist/entries","href":"/en/api-reference/endpoints/calendar/list-waiting-list-entries"},{"title":"Remove a client from the waiting list","openapi":"DELETE /api/v2/public/calendar/waitlist/entries/{entry_id}","href":"/en/api-reference/endpoints/calendar/remove-a-client-from-the-waiting-list"},{"title":"Get waiting-list totals","openapi":"GET /api/v2/public/calendar/waitlist/summary","href":"/en/api-reference/endpoints/calendar/get-waiting-list-totals"}]},{"group":"WhatsApp","pages":[{"title":"List WhatsApp conversations","openapi":"GET /api/v2/public/whatsapp/conversations","href":"/en/api-reference/endpoints/whatsapp/list-whatsapp-conversations"},{"title":"List messages in a WhatsApp conversation","openapi":"GET /api/v2/public/whatsapp/conversations/{session_id}/messages","href":"/en/api-reference/endpoints/whatsapp/list-messages-in-a-whatsapp-conversation"}]}]}]}]}]},"title":"Create a client - Dialtu","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}