All of WotNot's APIs use Bearer token authentication. Send your account token as Bearer <token>. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account.
Body
application/json
The contacts to create or update. Each contact needs an email or a phone. Put all custom contact variables in custom_variables.
The contacts that already existed and were updated.
Show child attributes
Last modified on October 22, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"WotNot","description":"Official WotNot documentation. WotNot is a no-code platform for automating customer conversations with AI Agents on Websites, WhatsApp, Instagram, Email, Mobile apps, and Voice.","colors":{"primary":"#141414","light":"#D4D4D4","dark":"#141414"},"logo":{"light":"https://mintcdn.com/wotnot/o37K8lyT2Z_o0x92/images/fullblack.svg?fit=max\u0026auto=format\u0026n=o37K8lyT2Z_o0x92\u0026q=85\u0026s=4dfa08701dcc20afca4595cbfb547804","dark":"https://mintcdn.com/wotnot/o37K8lyT2Z_o0x92/images/fullwhite.svg?fit=max\u0026auto=format\u0026n=o37K8lyT2Z_o0x92\u0026q=85\u0026s=3bfcd2981bfc3a8eab403f5f4d527244","href":"https://wotnot.io"},"favicon":{"light":"https://mintcdn.com/wotnot/o37K8lyT2Z_o0x92/images/icon.svg?fit=max\u0026auto=format\u0026n=o37K8lyT2Z_o0x92\u0026q=85\u0026s=5e8a7f6f7b7d15e3af99771027edba5d","dark":"https://mintcdn.com/wotnot/o37K8lyT2Z_o0x92/images/icon.svg?fit=max\u0026auto=format\u0026n=o37K8lyT2Z_o0x92\u0026q=85\u0026s=5e8a7f6f7b7d15e3af99771027edba5d"},"navbar":{"links":[{"href":"mailto:support@wotnot.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.wotnot.io"}},"footer":{"socials":{"x":"https://x.com/wotnot_io","linkedin":"https://www.linkedin.com/company/wotnot-io","youtube":"https://www.youtube.com/c/WotNot-io","website":"https://wotnot.io"}},"fonts":{"family":"Inter"},"integrations":{"posthog":{"apiKey":"phc_qpdLU97h6kaY5SAAvjZi9FeFyrnSX3twYoaFQQoptzdF","apiHost":"https://analytics.wotnot.io","sessionRecording":false}},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"book-open-cover","href":"https://product.wotnot.io/docs"},{"anchor":"Chatbot Tutorials","icon":"youtube","href":"https://www.youtube.com/playlist?list=PLGWj1ASfMDAE"},{"anchor":"Platform Tutorial","icon":"newspaper","href":"https://www.youtube.com/playlist?list=PLkWf3r2dTB-LeKqNZZgoJG_FTNYMUqnMw"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"wotnot","hasAudioNarration":false,"actualSubdomain":"wotnot","customDomains":["help.wotnot.io"],"gitSource":{"type":"github","owner":"hardikmakadia1001","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adf184f9fac823faefcf6a2","collectionId":"a89bcdcf-1604-45f3-ae29-2c077df27773","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf184f9fac823faefcf6a2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6aede8fe27d3b48d167b52a8","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Documentation","count":95},{"language":"default","tag":"Build","count":58},{"language":"default","tag":"Action blocks","count":36},{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"Whitelabel","count":22},{"language":"default","tag":"Integrations","count":20},{"language":"default","tag":"Deploy","count":15},{"language":"default","tag":"Setting Up","count":15},{"language":"default","tag":"Channels","count":14},{"language":"default","tag":"Account management","count":11}]},"assistantConfig":{},"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"create-contact","slug":"/create-contact","pageMetadata":{"title":"Create contacts","openapi":"api-reference/create-contacts.json POST /v1/conversations","description":"Creates new contacts and updates existing ones, in one request.","href":"/create-contact"},"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 new contacts and updates existing ones, in one request.\"\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 contacts","openapi":"api-reference/create-contacts.json POST /v1/conversations","description":"Creates new contacts and updates existing ones, in one request.","href":"/create-contact"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create contacts","description":"Creates new contacts and updates existing ones, in one request.","operationId":"createContacts","requestBody":"6901e718-afc6-4f56-9d2a-76e56095fa41","responses":{"200":"049bb2be-f14f-4fc1-9451-aff1d67fd49c","400":"c20eedfe-ed8e-46f9-a338-00a5b6861d1e","401":"971d2edb-00a5-4d4f-b257-3519e9936ba4"},"method":"post","type":"path","servers":["1dcca49b-d13c-4beb-9a7a-00f9b67f9d98"],"security":["049b04b1-65ec-48d5-83d7-134ee6e96b37"],"path":"/v1/conversations","baseUrlOptions":["https://api.wotnot.io"],"title":"Create contacts","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"description":"The contacts to create or update. Each contact needs an `email` or a `phone`. Put all custom contact variables in `custom_variables`.","content":{"application/json":{"schema":{"type":"object","required":["contacts"],"properties":{"contacts":{"type":"array","description":"The contacts to create or update. Each one needs at least an `email` or a `phone`.","items":{"type":"object","properties":{"name":{"type":"string","description":"The contact's name.","example":"Michael Anderson","uniqueKey":"contacts.items.[INDEX].name","typeLabel":"string"},"email":{"type":"string","description":"The contact's email address. Required if you don't send `phone`.","example":"michael.anderson@example.com","uniqueKey":"contacts.items.[INDEX].email","typeLabel":"string"},"phone":{"type":"string","description":"The contact's phone number, for example `+1212555`. Required if you don't send `email`.","example":"+1212555","uniqueKey":"contacts.items.[INDEX].phone","typeLabel":"string"},"custom_variables":{"type":"object","description":"Your custom contact variables, as name and value pairs, for example `\"company\": \"Example Company\"`.","additionalProperties":{"type":"string","description":"The value of one custom contact variable. The key is the variable's name.","uniqueKey":"contacts.items.[INDEX].custom_variables.additionalProperties","typeLabel":"string"},"uniqueKey":"contacts.items.[INDEX].custom_variables","typeLabel":"object"}},"uniqueKey":"contacts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"contacts","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"contacts":[{"name":"Michael Anderson","email":"michael.anderson@example.com","phone":"+1212555","custom_variables":{"company":"Example Company"}},{"name":"Jessica Martinez","email":"jessica.martinez@example.com","phone":"+111221555","custom_variables":{"company":"Example Company"}}]},"examples":{"Example":{"title":"Example","value":{"contacts":[{"name":"Michael Anderson","email":"michael.anderson@example.com","phone":"+1212555","custom_variables":{"company":"Example Company"}},{"name":"Jessica Martinez","email":"jessica.martinez@example.com","phone":"+111221555","custom_variables":{"company":"Example Company"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"049bb2be-f14f-4fc1-9451-aff1d67fd49c":{"description":"Returns the contacts that were `created` (new) and the ones that were `updated` (already existed).","content":{"application/json":{"schema":{"type":"object","required":["created","updated"],"properties":{"created":{"type":"array","description":"The new contacts that were created.","items":{"type":"object","description":"One contact that was saved.","required":["id","external_key","key","ok"],"properties":{"id":{"type":"integer","description":"The contact's ID.","example":24135508,"isRequired":true,"uniqueKey":"created.items.[INDEX].id","typeLabel":"integer"},"external_key":{"type":"string","description":"The contact's external key, for example `111221555_13361`.","example":"111221555_13361","isRequired":true,"uniqueKey":"created.items.[INDEX].external_key","typeLabel":"string"},"key":{"type":"string","description":"A unique key for the contact.","example":"6AFH8gyvwKCB073815082213IgPXtWMj","isRequired":true,"uniqueKey":"created.items.[INDEX].key","typeLabel":"string"},"ok":{"type":"boolean","description":"`true` when this contact was saved.","example":true,"isRequired":true,"uniqueKey":"created.items.[INDEX].ok","typeLabel":"boolean"}},"uniqueKey":"created.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"created","typeLabel":"object[]"},"updated":{"type":"array","description":"The contacts that already existed and were updated.","items":{"type":"object","description":"One contact that was saved.","required":["id","external_key","key","ok"],"properties":{"id":{"type":"integer","description":"The contact's ID.","example":24135508,"isRequired":true,"uniqueKey":"updated.items.[INDEX].id","typeLabel":"integer"},"external_key":{"type":"string","description":"The contact's external key, for example `111221555_13361`.","example":"111221555_13361","isRequired":true,"uniqueKey":"updated.items.[INDEX].external_key","typeLabel":"string"},"key":{"type":"string","description":"A unique key for the contact.","example":"6AFH8gyvwKCB073815082213IgPXtWMj","isRequired":true,"uniqueKey":"updated.items.[INDEX].key","typeLabel":"string"},"ok":{"type":"boolean","description":"`true` when this contact was saved.","example":true,"isRequired":true,"uniqueKey":"updated.items.[INDEX].ok","typeLabel":"boolean"}},"uniqueKey":"updated.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"updated","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"created":[{"id":24135508,"external_key":"111221555_13361","key":"6AFH8gyvwKCB073815082213IgPXtWMj","ok":true}],"updated":[{"id":24135493,"external_key":"1212555_13361","key":"7oFMaCsVoDD2073727174868hp2AavON","ok":true}]},"examples":{"Example":{"title":"Example","value":{"created":[{"id":24135508,"external_key":"111221555_13361","key":"6AFH8gyvwKCB073815082213IgPXtWMj","ok":true}],"updated":[{"id":24135493,"external_key":"1212555_13361","key":"7oFMaCsVoDD2073727174868hp2AavON","ok":true}]}}},"exampleType":"examples"}},"exampleType":"examples"},"c20eedfe-ed8e-46f9-a338-00a5b6861d1e":{"description":"Something in the body is invalid, for example a contact has neither `email` nor `phone`. Each item in `message` points to one problem.","content":{"application/json":{"schema":{"type":"object","description":"Returned when one or more fields in the request body are invalid.","required":["error","ok","status","message"],"properties":{"error":{"type":"string","description":"`BAD_REQUEST` for this kind of error.","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"type":"boolean","description":"Always `false` when something went wrong.","example":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","example":400,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"message":{"type":"array","description":"A list of problems with the request, one item per problem.","items":{"type":"object","required":["message","path"],"properties":{"message":{"type":"string","description":"What is wrong with this field, for example `\"url\" must be a valid uri`.","example":"\"url\" must be a valid uri","isRequired":true,"uniqueKey":"message.items.[INDEX].message","typeLabel":"string"},"path":{"type":"array","description":"Where the problem is in your request body. For example, `[\"urls\", 0]` means the first item in `urls`.","items":{"oneOf":[{"type":"string","uniqueKey":"message.items.[INDEX].path.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"message.items.[INDEX].path.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"message.items.[INDEX].path.items.[INDEX]","typeLabel":"string | integer"},"isRequired":true,"uniqueKey":"message.items.[INDEX].path","typeLabel":"(string | integer)[]"}},"uniqueKey":"message.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"message","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"BAD_REQUEST","ok":false,"status":400,"message":[{"message":"\"contacts[0]\" must contain at least one of [email, phone]","path":["contacts",0]}]},"examples":{"Example":{"title":"Example","value":{"error":"BAD_REQUEST","ok":false,"status":400,"message":[{"message":"\"contacts[0]\" must contain at least one of [email, phone]","path":["contacts",0]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"971d2edb-00a5-4d4f-b257-3519e9936ba4":{"description":"The token is missing or wrong. Check that the `Authorization` header is `Bearer` followed by your account token.","content":{"application/json":{"schema":{"type":"object","description":"Returned whenever a request fails.","required":["error","ok","status","message"],"properties":{"error":{"type":"string","description":"A short error code in capital letters, for example `UNAUTHORIZED`. Check this in your code to tell errors apart.","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"ok":{"type":"boolean","description":"Always `false` when something went wrong.","example":false,"isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body, for example `401`.","example":401,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"message":{"type":"string","description":"What went wrong and how to fix it, in plain words.","example":"Invalid token. Provide the valid account token.","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"UNAUTHORIZED","ok":false,"status":401,"message":"Invalid token. Provide the valid account token."},"examples":{"Example":{"title":"Example","value":{"error":"UNAUTHORIZED","ok":false,"status":401,"message":"Invalid token. Provide the valid account token."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"049b04b1-65ec-48d5-83d7-134ee6e96b37":{"bearerAuth":{"type":"http","scheme":"bearer","description":"All of WotNot's APIs use Bearer token authentication. Send your account token as `Bearer \u003ctoken>`. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1dcca49b-d13c-4beb-9a7a-00f9b67f9d98":{"url":"https://api.wotnot.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"All of WotNot's APIs use Bearer token authentication. Send your account token as `Bearer \u003ctoken>`. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"All of WotNot's APIs use Bearer token authentication. Send your account token as `Bearer \u003ctoken>`. You can find it in Settings > Account Settings > Developer. Keep it on your server: anyone who has it can call the API as your account.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/create-contacts.json"},"subdomain":"wotnot","siteName":"WotNot","title":"Create contacts - WotNot","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T09:51:58.474Z","gitLastModified":"2026-10-22T09:50:00.000Z","originalFileLocation":"create-contact.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 new contacts and updates existing ones, in one request.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WotNot\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_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/wotnot/8-BMyhs8AwEwoRlA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create contacts - WotNot\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates new contacts and updates existing ones, in one request.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WotNot\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.wotnot.io/create-contact\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://wotnot.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Create+contacts\u0026amp;description=Creates+new+contacts+and+updates+existing+ones%2C+in+one+request.\u0026amp;theme=d9717b5e43a8114c1f6e4db6\u0026amp;signature=2cfffec6b4244c069a04783b2850ef6bd2dbda6964effe147b21516faa4ddc92\">\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 contacts - WotNot\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates new contacts and updates existing ones, in one request.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://wotnot.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Create+contacts\u0026amp;description=Creates+new+contacts+and+updates+existing+ones%2C+in+one+request.\u0026amp;theme=d9717b5e43a8114c1f6e4db6\u0026amp;signature=2cfffec6b4244c069a04783b2850ef6bd2dbda6964effe147b21516faa4ddc92\">\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/wotnot/8-BMyhs8AwEwoRlA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WotNot\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#141414\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.wotnot.io/create-contact\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/create-contact.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WotNot\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"WotNot","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"book-open-cover","href":"https://product.wotnot.io/docs"},{"anchor":"Chatbot Tutorials","icon":"youtube","href":"https://www.youtube.com/playlist?list=PLGWj1ASfMDAE"},{"anchor":"Platform Tutorial","icon":"newspaper","href":"https://www.youtube.com/playlist?list=PLkWf3r2dTB-LeKqNZZgoJG_FTNYMUqnMw"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting started","pages":[{"title":"Welcome to WotNot","href":"/getting-started/welcome"},{"title":"Building your first chatbot","href":"/getting-started/building-chatbot"},{"title":"Build your first AI Agent","href":"/getting-started/building-ai-agent"}]},{"group":"Build","pages":[{"title":"Bot Builder","href":"/build/bot-builder"},{"group":"Action blocks","pages":[{"title":"Trigger","href":"/build/blocks/trigger"},{"title":"Send Message","href":"/build/blocks/send-message"},{"title":"Image gallery","href":"/build/blocks/image-gallery"},{"title":"Collect Input","href":"/build/blocks/collect-input"},{"title":"Collect File","href":"/build/blocks/collect-file"},{"title":"Collect Location","href":"/build/blocks/collect-location"},{"title":"WhatsApp Flow","href":"/build/blocks/whatsapp-flow"},{"title":"Reply Buttons","href":"/build/blocks/reply-buttons"},{"title":"Catalogue","href":"/build/blocks/catalogue"},{"title":"Buttons","href":"/build/blocks/buttons"},{"title":"Options","href":"/build/blocks/options"},{"title":"Form","href":"/build/blocks/form"},{"title":"List","href":"/build/blocks/list"},{"title":"Carousel","href":"/build/blocks/carousel"},{"title":"Carousel","href":"/build/blocks/carousel"},{"title":"Slider","href":"/build/blocks/slider"},{"title":"Calendar","href":"/build/blocks/calendar"},{"title":"Condition","href":"/build/blocks/condition"},{"title":"Jump","href":"/build/blocks/jump"},{"title":"Delay","href":"/build/blocks/delay"},{"title":"Javascript","href":"/build/blocks/javascript"},{"title":"Webhook","href":"/build/blocks/webhook"},{"title":"Talk to human","href":"/build/blocks/talk-to-human"},{"title":"Send an email","href":"/build/blocks/send-an-email"},{"title":"AI Agent","href":"/build/blocks/ai-agent"},{"title":"Answer AI","href":"/build/blocks/answer-ai"},{"title":"Answer AI","href":"/build/blocks/answer-ai"},{"title":"Set AI","href":"/build/blocks/set-ai"},{"title":"Set Variable","href":"/build/blocks/set-variable"},{"title":"Flow","href":"/build/blocks/flow"},{"title":"Dynamic data ","href":"/build/blocks/dynamic-data"},{"title":"Codeblock","href":"/build/blocks/codeblock"},{"title":"Send SMS","href":"/build/blocks/send-sms"},{"title":"Send MMS","href":"/build/blocks/send-mms"},{"title":"Send Email","href":"/build/blocks/send-email"},{"title":"Send WhatsApp","href":"/build/blocks/send-whatsapp"},{"title":"Send Status","href":"/build/blocks/send-status"},{"title":"Send Template","href":"/build/blocks/send-template"}]},{"title":"Knowledge base","href":"/build/knowledge-base"},{"title":"Prompts","href":"/build/prompts"},{"title":"Functions","href":"/build/functions"},{"group":"Campaigns","pages":[{"title":"Outbound Campaign - One off","href":"/campaigns/one-off"},{"title":"Outbound Campaign - Ongoing","href":"/campaigns/ongoing"}]},{"group":"Data","pages":[{"title":"Variables","href":"/data/variables"},{"title":"Contacts","href":"/data/contacts"}]},{"group":"Integrations","pages":[{"title":"HTTP request/API","href":"/build/integrations/http-request-api"},{"title":"Zapier","href":"/build/integrations/zapier"},{"title":"Salesforce","href":"/build/integrations/salesforce"},{"title":"HubSpot ","href":"/build/integrations/hubspot"},{"title":"Zoho CRM","href":"/build/integrations/zoho-crm"},{"title":"Airtable","href":"/build/integrations/airtable"},{"title":"Slack","href":"/build/integrations/slack"},{"title":"Outlook Calendar","href":"/build/integrations/outlook-calendar"},{"title":"Google Calendar","href":"/build/integrations/google-calendar"},{"title":"Google Sheets","href":"/build/integrations/google-sheets"},{"title":"Google Analytics","href":"/build/integrations/google-analytics"},{"title":"Calendly","href":"/build/integrations/calendly"},{"title":"Zendesk","href":"/build/integrations/zendesk"},{"title":"Freshdesk","href":"/build/integrations/freshdesk"}]}]},{"group":"Operate","pages":[{"title":"Operate","href":"/operate"},{"group":"Live Chat","pages":[{"title":"Live Chat","href":"/operate/live-chat/overview"},{"title":"Creating Views","href":"/operate/live-chat/creating-view"},{"title":"Adding Labels","href":"/operate/live-chat/adding-labels"},{"title":"Saved Replies","href":"/operate/live-chat/saved-replies"},{"title":"Voice Transcripts","href":"/operate/live-chat/voice-transcripts"},{"title":"Chat assignment log ","href":"/operate/live-chat/chat-assignment-log"},{"title":"Live Chat Settings","href":"/operate/live-chat/settings"}]},{"title":"Custom Answers","href":"/operate/custom-answers"},{"title":"Automations","href":"/operate/automations"}]},{"group":"Deploy","pages":[{"title":"Testing","href":"/deploy/testing"},{"group":"Channels","pages":[{"title":"Channels","href":"/deploy/channels"},{"title":"Web","href":"/deploy/channels/web"},{"group":"WhatsApp","pages":[{"title":"WhatsApp","href":"/deploy/channels/whatsapp"},{"title":"WhatsApp Template","href":"/deploy/channels/whatsapp/templates"},{"title":"Messaging Limits and Quality Rating \u0026 cost","href":"/deploy/channels/whatsapp/messaging-quality-rating-cost"},{"title":"Green Tick (Official Business Account)","href":"/deploy/channels/whatsapp/green-tick"}]},{"title":"Instagram","href":"/deploy/channels/instagram"},{"title":"Facebook Messenger","href":"/deploy/channels/facebook"},{"title":"Email","href":"/deploy/channels/email"},{"title":"Mobile App","href":"/deploy/channels/mobile-app"},{"title":"Voice","href":"/deploy/channels/voice"},{"title":"SMS","href":"/deploy/channels/sms"},{"title":"API","href":"/deploy/channels/api"},{"title":"Chat Widget","href":"/deploy/channels/chat-widget"}]}]},{"group":"Reports","pages":[{"title":"Reports overview","href":"/reports/overview"},{"title":"Chatbot Report","href":"/reports/chatbot"},{"title":"AI Report","href":"/reports/ai-report"},{"title":"Human Agent Report","href":"/reports/human-agent"},{"title":"Ticketing Report","href":"/reports/ticketing"},{"title":"Outbound Report","href":"/reports/campaigns"},{"title":"Link Analytics","href":"/reports/link-analytics"}]},{"group":"Account","pages":[{"title":"Billing","href":"/account/billing"},{"title":"User Management","href":"/account/user-management"},{"title":"Account Settings","href":"/account/settings"}]}]},{"tab":"API Reference","groups":[{"group":"Getting started","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Webhook Events","href":"/api-reference/webhook-events"}]},{"group":"Bot","pages":[{"title":"Create bot","openapi":"POST /v1/bot","href":"/api-reference/create-bot"},{"title":"Get bot flow","openapi":"GET /v1/bots/{bot_id}/flow","href":"/api-reference/fetch-bot-flow"},{"title":"Deploy bot","openapi":"POST /v1/bots/{bot_id}/deploy","href":"/api-reference/deploy-bot"},{"title":"List bots","openapi":"GET /v1/accounts/{account_id}/bots","href":"/api-reference/fetch-bot-list"}]},{"group":"Knowledge Base","pages":[{"title":"Create knowledge base","openapi":"POST /v1/ai/knowledge-base","href":"/api-reference/create-kb"},{"title":"Upload data sources","openapi":"POST /api/v1/ai/knowledge-base/{knowledge_base_id}/upload/sources","href":"/api-reference/add-url-kb"},{"title":"Add URL data sources","openapi":"POST /v1/ai/knowledge-base/{knowledge_base_id}/data-sources/webpages","href":"/api-reference/add-domain"},{"title":"Add domain data source","openapi":"POST /v1/ai/knowledge-base/{knowledge_base_id}/data-sources/domain","href":"/api-reference/add-text-file-data-sources"},{"title":"Delete data sources","openapi":"DELETE /v1/ai/knowledge-bases/{knowledge_base_id}/data-sources","href":"/api-reference/delete-data-sources"},{"title":"Get training status","openapi":"GET /api/v1/ai/status/sources","href":"/api-reference/get-training-status"},{"title":"Get knowledge base","openapi":"GET /v1/ai/knowledge-base/{knowledge_base_id}","href":"/api-reference/fetch-kb"}]},{"group":"Conversation","pages":[{"title":"Create conversation","openapi":"api-reference/create-conversation.json POST /v1/conversations","href":"/api-reference/create-conversation"},{"title":"Send agent response","openapi":"POST /api/v1/conversation/{conversation_id}/messages","href":"/api-reference/close-conversation"},{"title":"Close conversation","openapi":"api-reference/close-conversation.json POST /api/v1/conversation/{conversation_id}/events","href":"/api-reference/agent-response"},{"title":"Change assignee","openapi":"api-reference/change-assignee.json POST /api/v1/conversation/{conversation_id}/events","href":"/api-reference/changing-assignee"},{"title":"Update variable","openapi":"POST /v1/accounts/{account_id}/conversations/{conversation_id}/variables","href":"/api-reference/update-variable"}]},{"group":"Contacts","pages":[{"title":"Create contacts","openapi":"api-reference/create-contacts.json POST /v1/conversations","href":"/api-reference/create-contact"}]},{"group":"Account management","pages":[{"title":"Get account roles","openapi":"GET /v1/accounts/{account_id}/user-roles","href":"/api-reference/fetch-account-roles"},{"title":"Invite user","openapi":"POST /v1/accounts/{account_id}/user","href":"/api-reference/invite-user"},{"title":"Update user role","openapi":"PUT /v1/accounts/{account_id}/users/{user_id}","href":"/api-reference/update-user-role"},{"title":"Remove user","openapi":"DELETE /v1/accounts/{account_id}/users/{user_id}","href":"/api-reference/remove-user"},{"title":"Set webhook URL","openapi":"POST /v1/accounts/{account_id}/webhook","href":"/api-reference/set-wehbook-url"}]}]},{"tab":"Whitelabel","pages":[{"group":"Setting Up","pages":[{"title":"Help Center","href":"/whitelabel/setting-up/help-center"},{"title":"Pricing","href":"/whitelabel/setting-up/pricing"},{"title":"Branding","href":"/whitelabel/setting-up/branding"},{"title":"Templates","href":"/whitelabel/setting-up/templates"},{"title":"Defaults","href":"/whitelabel/setting-up/defaults"},{"title":"Super Admin","href":"/whitelabel/setting-up/super-admin"},{"title":"Free trials","href":"/whitelabel/setting-up/free-trials"},{"title":"Analytics","href":"/whitelabel/analytics"},{"title":"Account events ","href":"/whitelabel/account-events"},{"group":"Integrations","pages":[{"title":"Live Translation","href":"/whitelabel/integrations/live-translation"},{"title":"Outlook Calendar","href":"/whitelabel/integrations/outlook-calendar"},{"title":"Stripe Billing ","href":"/whitelabel/integrations/stripe-billing"},{"title":"Facebook channel ","href":"/whitelabel/integrations/facebook-channel"},{"title":"Email channel ","href":"/whitelabel/integrations/email-channel"},{"title":"WhatsApp embedded signup ","href":"/whitelabel/integrations/whatsapp-embedded-signup"}]}]},{"title":"Feature list ","mode":"default","href":"/feature-list"},{"group":"Account management","pages":[{"title":"Creating account ","href":"/whitelabel/account-management/creating-account"},{"title":"Impersonating account","href":"/whitelabel/account-management/impersonating-account"},{"title":"Deleting account ","href":"/whitelabel/account-management/deleting-account"},{"title":"Enabling/Disabling features","href":"/whitelabel/account-management/enabling-disabling-features"},{"title":"Copying bots","href":"/whitelabel/account-management/copying-bots"},{"title":"Changing plan","href":"/whitelabel/account-management/changing-plan"}]}]},{"tab":"Help \u0026 Support","pages":[{"title":"Creating a ticket","href":"/creating-a-ticket"},{"title":"Deleting an account","href":"/deleting-account"},{"group":"FAQs","pages":[{"title":"Setting up link tracking ","href":"/setting-up-link-tracking"},{"title":"Getting notification for leads","href":"/getting-notification-for-leads"},{"title":"Tracking Facebook Pixel","href":"/tracking-facebook-pixel"},{"title":"How do I hard refresh my browser? ","href":"/how-do-i-hard-refresh-my-browser"}]}]}]},"basePath":"","title":"Create contacts - WotNot","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}