Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).
Map of custom field name to value (string). Only keys that exist as company CustomField names are stored.
Show child attributes
Response
Success. Empty response body (no JSON payload).
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Aidan","colors":{"primary":"#DD050E","light":"#DD050E","dark":"#DD050E"},"favicon":"https://mintcdn.com/aidan/OXXSgGv35zIqM21r/favicon.svg?fit=max\u0026auto=format\u0026n=OXXSgGv35zIqM21r\u0026q=85\u0026s=b655205c5355c37b653e9c24382b7b7f","logo":{"light":"https://mintcdn.com/aidan/5f0YMxiufk0VICtP/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=5f0YMxiufk0VICtP\u0026q=85\u0026s=5eb2415aefd08ad847d634b5e4ab077c","dark":"https://mintcdn.com/aidan/5f0YMxiufk0VICtP/logo/logo-light.png?fit=max\u0026auto=format\u0026n=5f0YMxiufk0VICtP\u0026q=85\u0026s=a5dd3def6794822a5508bdba4586aa37"},"navbar":{"links":[{"label":"Support","href":"mailto:support@callaidan.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.callaidan.com"}},"footer":{"socials":{"x":"https://x.com/getoutbox_ai","linkedin":"https://www.linkedin.com/company/outbox-ai/","facebook":"https://www.facebook.com/outboxai","instagram":"https://www.instagram.com/outboxai"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.callaidan.com","icon":"book-open-cover"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aidan","hasAudioNarration":false,"actualSubdomain":"aidan","customDomains":["docs.callaidan.com"],"gitSource":{"type":"github","owner":"call-aidan","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acb29e792b099bee571cfe2","collectionId":"d31eac1a-34bf-4f00-8e7a-edd124911daf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acb29e792b099bee571cfe2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6acb29e792b099bee571cfe2","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API Reference","count":120},{"language":"default","tag":"Workflows","count":22},{"language":"default","tag":"CRM Opportunities","count":14},{"language":"default","tag":"Email Providers, Domains \u0026 Senders","count":14},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Get Started","count":11},{"language":"default","tag":"Company Settings","count":10},{"language":"default","tag":"Agent Tools","count":6},{"language":"default","tag":"Agent Endpoints","count":6},{"language":"default","tag":"Tools","count":6}]},"assistantConfig":{"enableStarterQuestions":false},"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":"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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/contact-create","slug":"/api-reference/endpoint/contact-create","pageMetadata":{"title":"Create Contact","openapi":"POST /contacts/","description":"Create a new contact or update an existing one. If a contact already exists for the company by **email** or **phone**, that row is updated; otherwise a new contact is created. On upsert, new **tags** are merged with existing tags (deduplicated). Response body is empty (no JSON payload).","href":"/api-reference/endpoint/contact-create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a new contact or update an existing one. If a contact already exists for the company by \", _jsx(_components.strong, {\n children: \"email\"\n }), \" or \", _jsx(_components.strong, {\n children: \"phone\"\n }), \", that row is updated; otherwise a new contact is created. On upsert, new \", _jsx(_components.strong, {\n children: \"tags\"\n }), \" are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\"]\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 Contact","openapi":"POST /contacts/","description":"Create a new contact or update an existing one. If a contact already exists for the company by **email** or **phone**, that row is updated; otherwise a new contact is created. On upsert, new **tags** are merged with existing tags (deduplicated). Response body is empty (no JSON payload).","href":"/api-reference/endpoint/contact-create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create or upsert contact","description":"Create a new contact or update an existing one. If a contact already exists for the company by **email** or **phone**, that row is updated; otherwise a new contact is created. On upsert, new **tags** are merged with existing tags (deduplicated). Response body is empty (no JSON payload).","security":["11967924-dd70-4682-be3c-3342c6ce087d"],"requestBody":"5efe4da9-485c-4c91-9ea4-cce97663f0cc","responses":{"200":"48c43be2-e4c4-4a22-b2e5-8f7bf4541253","400":"2cb5f5d3-dbb0-4190-932f-544096a212a6","401":"0dcb89a8-56a8-4fea-9517-8a8d272fd920"},"method":"post","type":"path","servers":["3b9f3147-8a13-4d00-bdde-1b41cf51dc98"],"path":"/contacts/","baseUrlOptions":["https://api.callaidan.com"],"title":"Create or upsert contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Contact fields","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"full_name":{"type":"string","description":"Title-cased; split into first and last name","uniqueKey":"full_name","typeLabel":"string"},"email":{"type":"string","description":"Lowercased; optional","uniqueKey":"email","typeLabel":"string"},"phone_number":{"type":"string","description":"Normalized using the company's country when present","uniqueKey":"phone_number","typeLabel":"string"},"business_name":{"type":"string","uniqueKey":"business_name","typeLabel":"string"},"notes":{"type":"string","uniqueKey":"notes","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"On an existing contact, new tags are merged with existing tags (deduplicated)","uniqueKey":"tags","typeLabel":"string[]"},"is_dnd":{"oneOf":[{"type":"boolean","description":"Do-not-disturb; boolean or string variants accepted","uniqueKey":"is_dnd.oneOf.0","typeLabel":"boolean"},{"type":"string","description":"Do-not-disturb; boolean or string variants accepted","uniqueKey":"is_dnd.oneOf.1","typeLabel":"string"}],"uniqueKey":"is_dnd","typeLabel":"boolean | string"},"lead_source":{"type":"string","description":"Must be one of: manual, api, webhook, facebook, instagram, import. Invalid values are stored as manual.","uniqueKey":"lead_source","typeLabel":"string"},"custom_fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"custom_fields.additionalProperties","typeLabel":"string"},"description":"Map of custom field name to value (string). Only keys that exist as company CustomField names are stored.","uniqueKey":"custom_fields","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"full_name":"\u003cstring>","email":"\u003cstring>","phone_number":"\u003cstring>","business_name":"\u003cstring>","notes":"\u003cstring>","tags":["\u003cstring>"],"is_dnd":true,"lead_source":"\u003cstring>","custom_fields":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"48c43be2-e4c4-4a22-b2e5-8f7bf4541253":{"description":"Success. Empty response body (no JSON payload).","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2cb5f5d3-dbb0-4190-932f-544096a212a6":{"description":"Bad Request - Invalid contact data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0dcb89a8-56a8-4fea-9517-8a8d272fd920":{"description":"Unauthorized - Invalid or missing API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"11967924-dd70-4682-be3c-3342c6ce087d":{"CompanyApiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Company API Key","scopes":[]}}},"servers":{"3b9f3147-8a13-4d00-bdde-1b41cf51dc98":{"url":"https://api.callaidan.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Company API Key","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Company API Key","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"CompanyApiKey","name":"Authorization"}],"title":"CompanyApiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"aidan","siteName":"Aidan","title":"Create Contact - Aidan","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-10T04:14:53.265Z","originalFileLocation":"api-reference/endpoint/contact-create.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=\"Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aidan\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_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/aidan/LqHUeleQ9emmBQ7M/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Contact - Aidan\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aidan\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.callaidan.com/api-reference/endpoint/contact-create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aidan.mintlify.app/_mintlify/api/og/v2?division=Contact+Endpoints\u0026amp;title=Create+Contact\u0026amp;description=Create+a+new+contact+or+update+an+existing+one.+If+a+contact+already+exists+for+the+company+by+**email**+or+**phone**%2C+that+row+is+updated%3B+otherwise+a+new+cont\u0026amp;theme=830caa7b0325430e77e46805\u0026amp;signature=f49dae121d33c71fe5882e584e61dd75daba66e6f283fb402cbdb83adcbaa1c4\">\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 Contact - Aidan\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aidan.mintlify.app/_mintlify/api/og/v2?division=Contact+Endpoints\u0026amp;title=Create+Contact\u0026amp;description=Create+a+new+contact+or+update+an+existing+one.+If+a+contact+already+exists+for+the+company+by+**email**+or+**phone**%2C+that+row+is+updated%3B+otherwise+a+new+cont\u0026amp;theme=830caa7b0325430e77e46805\u0026amp;signature=f49dae121d33c71fe5882e584e61dd75daba66e6f283fb402cbdb83adcbaa1c4\">\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/aidan/LqHUeleQ9emmBQ7M/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aidan\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#DD050E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.callaidan.com/api-reference/endpoint/contact-create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/contact-create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.callaidan.com/#organization\",\"name\":\"Aidan\",\"url\":\"https://docs.callaidan.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aidan/5f0YMxiufk0VICtP/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=5f0YMxiufk0VICtP\u0026q=85\u0026s=5eb2415aefd08ad847d634b5e4ab077c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.callaidan.com#website\",\"name\":\"Aidan\",\"url\":\"https://docs.callaidan.com\",\"publisher\":{\"@id\":\"https://docs.callaidan.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create#webpage\",\"url\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create\",\"name\":\"Create Contact\",\"description\":\"Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\",\"dateModified\":\"2026-05-10T04:14:53.265Z\",\"isPartOf\":{\"@id\":\"https://docs.callaidan.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contact Endpoints\",\"item\":\"https://docs.callaidan.com/api-reference/endpoint/contact-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Contact\",\"item\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create#apireference\",\"headline\":\"Create Contact\",\"name\":\"Create Contact\",\"description\":\"Create a new contact or update an existing one. If a contact already exists for the company by email or phone, that row is updated; otherwise a new contact is created. On upsert, new tags are merged with existing tags (deduplicated). Response body is empty (no JSON payload).\",\"url\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.callaidan.com/api-reference/endpoint/contact-create#webpage\"},\"dateModified\":\"2026-05-10T04:14:53.265Z\",\"publisher\":{\"@id\":\"https://docs.callaidan.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.callaidan.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aidan\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Aidan","nav":{"global":{"anchors":[{"anchor":"Documentation","href":"https://docs.callaidan.com","icon":"book-open-cover"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Analytics","pages":[{"title":"Get Analytics","openapi":"GET /analytics/","href":"/api-reference/endpoint/analytics-get"}]},{"group":"Agent Endpoints","pages":[{"title":"List Agents","openapi":"GET /agent/list","href":"/api-reference/endpoint/list"},{"title":"Get Agent","openapi":"GET /agent/{agent_id}/","href":"/api-reference/endpoint/get"},{"title":"Create Agent","openapi":"POST /agent/","href":"/api-reference/endpoint/create"},{"title":"Update Agent","openapi":"PATCH /agent/{agent_id}/","href":"/api-reference/endpoint/update"},{"title":"Duplicate Agent","openapi":"POST /agent/duplicate/{agent_id}","href":"/api-reference/endpoint/duplicate"},{"title":"Delete Agent","openapi":"DELETE /agent/{agent_id}/","href":"/api-reference/endpoint/delete"}]},{"group":"Chat \u0026 Call Endpoints","pages":[{"title":"Send Chat Message","openapi":"POST /agent/chat/{agent_id}","href":"/api-reference/endpoint/chat"},{"title":"Send AI Call","openapi":"POST /agent/call/{agent_id}","href":"/api-reference/endpoint/call"}]},{"group":"Call Logs","pages":[{"title":"List Call Logs","openapi":"GET /agent/call-logs/","href":"/api-reference/endpoint/call-logs"},{"title":"Download Call Logs","openapi":"POST /agent/call-logs/download/","href":"/api-reference/endpoint/call-logs-download"}]},{"group":"Chat Logs","pages":[{"title":"List Chat Logs","openapi":"GET /agent/chat-logs/","href":"/api-reference/endpoint/chat-logs"},{"title":"Download Chat Logs","openapi":"POST /agent/chat-logs/download/","href":"/api-reference/endpoint/chat-logs-download"}]},{"group":"Transcripts","pages":[{"title":"List Transcripts","openapi":"GET /agent/transcript/list","href":"/api-reference/endpoint/transcript-list"},{"title":"List Transcripts by Agent","openapi":"GET /agent/transcript/list/{agent_id}","href":"/api-reference/endpoint/transcript-list-agent"},{"title":"Get Transcript","openapi":"GET /agent/transcript/{transcript_id}","href":"/api-reference/endpoint/transcript-get"},{"title":"Download Transcript","openapi":"GET /agent/transcript/download/{transcript_id}/","href":"/api-reference/endpoint/transcript-download"},{"title":"Get Transcript Tool Call","openapi":"GET /agent/transcript/tool/{tool_call_id}/","href":"/api-reference/endpoint/transcript-tool"}]},{"group":"Call Queue","pages":[{"title":"Import Call Queue","openapi":"POST /agent/queue/import/","href":"/api-reference/endpoint/agent-queue-import"},{"title":"List Call Queue","openapi":"GET /agent/queue/","href":"/api-reference/endpoint/agent-queue-list"},{"title":"Bulk Update Call Queue","openapi":"POST /agent/queue/bulk/","href":"/api-reference/endpoint/agent-queue-bulk"}]},{"group":"Agent Files","pages":[{"title":"Get File Content","openapi":"GET /agent/file/{file_id}","href":"/api-reference/endpoint/file-get"},{"title":"Upload File","openapi":"POST /agent/file","href":"/api-reference/endpoint/file-upload"},{"title":"Update File Content","openapi":"PATCH /agent/file/{file_id}","href":"/api-reference/endpoint/file-update"},{"title":"Delete File","openapi":"DELETE /agent/file/{file_id}","href":"/api-reference/endpoint/file-delete"}]},{"group":"Agent Integrations","pages":[{"title":"Create/Update Platform Integration","openapi":"POST /agent/integration/{agent_id}","href":"/api-reference/endpoint/integration-create"},{"title":"Update Integration","openapi":"PATCH /agent/integration","href":"/api-reference/endpoint/integration-update"},{"title":"Delete Integration","openapi":"DELETE /agent/integration","href":"/api-reference/endpoint/integration-delete"}]},{"group":"Agent Tools","pages":[{"title":"List Agent Tools","openapi":"GET /agent/tool/{agent_id}","href":"/api-reference/endpoint/tool-list"},{"title":"List Built-In Agent Tools","openapi":"GET /agent/tool/builtins/","href":"/api-reference/endpoint/tool-builtins-list"},{"title":"Create/Update Tool","openapi":"POST /agent/tool/{agent_id}","href":"/api-reference/endpoint/tool-create"},{"title":"Delete Tool","openapi":"DELETE /agent/tool","href":"/api-reference/endpoint/tool-delete"},{"title":"Run Agent Tool","openapi":"POST /agent/tool/run/{tool_id}/","href":"/api-reference/endpoint/agent-tool-run"},{"title":"List Agent MCP Tools","openapi":"POST /agent/tool/mcp/","href":"/api-reference/endpoint/agent-tool-mcp"}]},{"group":"Tools","pages":[{"title":"List Tools","openapi":"GET /module/instance/list","href":"/api-reference/endpoint/module-list"},{"title":"Get Tool","openapi":"GET /module/instance/{instance_id}","href":"/api-reference/endpoint/module-get"},{"title":"Create Tool","openapi":"POST /module/instance","href":"/api-reference/endpoint/module-create"},{"title":"Update Tool","openapi":"PATCH /module/instance/{instance_id}","href":"/api-reference/endpoint/module-update"},{"title":"Duplicate Tool","openapi":"POST /module/instance/duplicate/{instance_id}","href":"/api-reference/endpoint/module-duplicate"},{"title":"Delete Tool","openapi":"DELETE /module/instance/{instance_id}","href":"/api-reference/endpoint/module-delete"}]},{"group":"Contact Endpoints","pages":[{"title":"List Contacts","openapi":"GET /contacts/list","href":"/api-reference/endpoint/contact-list"},{"title":"Get Contact","openapi":"GET /contacts/{contact_id}/","description":"Retrieve detailed information about a specific contact including recent activity (up to 3 most recent AgentThread rows). `active_chat_agent` may be null.","href":"/api-reference/endpoint/contact-get"},{"title":"Create Contact","openapi":"POST /contacts/","href":"/api-reference/endpoint/contact-create"},{"title":"Update Contact","openapi":"PATCH /contacts/{contact_id}/","description":"Update an existing contact. Only fields present in the JSON body are applied.","href":"/api-reference/endpoint/contact-update"},{"title":"Delete Contact","openapi":"DELETE /contacts/{contact_id}/","href":"/api-reference/endpoint/contact-delete"}]},{"group":"Conversation Endpoints","pages":[{"title":"List Conversations","openapi":"GET /conversations/list","href":"/api-reference/endpoint/conversation-list"},{"title":"Get Conversation","openapi":"GET /conversations/{contact_id}","href":"/api-reference/endpoint/conversation-get"}]},{"group":"Send Messages","pages":[{"title":"Send SMS","openapi":"POST /contact/send/sms/","href":"/api-reference/endpoint/send-sms"},{"title":"Send Email","openapi":"POST /contact/send/email/","href":"/api-reference/endpoint/send-email"},{"title":"Send Facebook Message","openapi":"POST /contact/send/facebook/","href":"/api-reference/endpoint/send-facebook"},{"title":"Send Instagram Message","openapi":"POST /contact/send/instagram/","href":"/api-reference/endpoint/send-instagram"}]},{"group":"Workflows","pages":[{"title":"List Workflows","openapi":"GET /workflow/","href":"/api-reference/endpoint/workflow-list"},{"title":"Get Workflow","openapi":"GET /workflow/{workflow_id}/","href":"/api-reference/endpoint/workflow-get"},{"title":"Create Workflow","openapi":"POST /workflow/","href":"/api-reference/endpoint/workflow-create"},{"title":"Update Workflow","openapi":"PATCH /workflow/{workflow_id}/","href":"/api-reference/endpoint/workflow-update"},{"title":"Delete Workflow","openapi":"DELETE /workflow/{workflow_id}/","href":"/api-reference/endpoint/workflow-delete"},{"title":"Duplicate Workflow","openapi":"POST /workflow/{workflow_id}/duplicate/","href":"/api-reference/endpoint/workflow-duplicate"},{"title":"List Workflow Folders","openapi":"GET /workflow/folder/","href":"/api-reference/endpoint/workflow-folder-list"},{"title":"Create Workflow Folder","openapi":"POST /workflow/folder/","href":"/api-reference/endpoint/workflow-folder-create"},{"title":"Update Workflow Folder","openapi":"PATCH /workflow/folder/{folder_id}/","href":"/api-reference/endpoint/workflow-folder-update"},{"title":"Delete Workflow Folder","openapi":"DELETE /workflow/folder/{folder_id}/","href":"/api-reference/endpoint/workflow-folder-delete"},{"title":"List Workflow Executions","openapi":"GET /workflow/{workflow_id}/executions/","href":"/api-reference/endpoint/workflow-executions"},{"title":"List All Workflow Executions","openapi":"GET /workflow/executions/","href":"/api-reference/endpoint/workflow-executions-all"},{"title":"List All Execution Logs","openapi":"GET /workflow/executions/logs/","href":"/api-reference/endpoint/workflow-execution-logs-all"},{"title":"List Workflow Enrollments","openapi":"GET /workflow/{workflow_id}/enrollments/","href":"/api-reference/endpoint/workflow-enrollments-list"},{"title":"Add Workflow Enrollments","openapi":"POST /workflow/{workflow_id}/enrollments/add/","href":"/api-reference/endpoint/workflow-enrollments-add"},{"title":"Remove Workflow Enrollments","openapi":"POST /workflow/{workflow_id}/enrollments/remove/","href":"/api-reference/endpoint/workflow-enrollments-remove"},{"title":"Remove Workflow Enrollment","openapi":"DELETE /workflow/enrollments/{enrollment_id}/","href":"/api-reference/endpoint/workflow-enrollment-detail"},{"title":"List All Enrollment History","openapi":"GET /workflow/enrollments/history/","href":"/api-reference/endpoint/workflow-enrollment-history"},{"title":"List Enrollment Execution Logs","openapi":"GET /workflow/enrollments/{enrollment_id}/executions/","href":"/api-reference/endpoint/workflow-enrollment-execution-logs"},{"title":"List Contacts Waiting on Action","openapi":"GET /workflow/{workflow_id}/actions/{action_id}/waiting/","href":"/api-reference/endpoint/workflow-action-waiting"},{"title":"Advance Contacts on Action","openapi":"POST /workflow/{workflow_id}/actions/{action_id}/advance/","href":"/api-reference/endpoint/workflow-action-advance"},{"title":"Remove Contacts from Action","openapi":"POST /workflow/{workflow_id}/actions/{action_id}/remove/","href":"/api-reference/endpoint/workflow-action-remove"}]},{"group":"CRM Opportunities","pages":[{"title":"List Pipelines","openapi":"GET /crm/pipelines/","href":"/api-reference/endpoint/crm-pipelines-list"},{"title":"Get Pipeline","openapi":"GET /crm/pipelines/{pipeline_id}/","href":"/api-reference/endpoint/crm-pipeline-get"},{"title":"Create Pipeline","openapi":"POST /crm/pipelines/","href":"/api-reference/endpoint/crm-pipeline-create"},{"title":"Update Pipeline","openapi":"PATCH /crm/pipelines/{pipeline_id}/","href":"/api-reference/endpoint/crm-pipeline-update"},{"title":"Delete Pipeline","openapi":"DELETE /crm/pipelines/{pipeline_id}/","href":"/api-reference/endpoint/crm-pipeline-delete"},{"title":"List Pipeline Stages","openapi":"GET /crm/pipelines/{pipeline_id}/stages/","href":"/api-reference/endpoint/crm-pipeline-stages-list"},{"title":"Create Pipeline Stage","openapi":"POST /crm/pipelines/{pipeline_id}/stages/","href":"/api-reference/endpoint/crm-pipeline-stage-create"},{"title":"Update Pipeline Stage","openapi":"PATCH /crm/pipeline-stages/{stage_id}/","href":"/api-reference/endpoint/crm-pipeline-stage-update"},{"title":"Delete Pipeline Stage","openapi":"DELETE /crm/pipeline-stages/{stage_id}/","href":"/api-reference/endpoint/crm-pipeline-stage-delete"},{"title":"List Opportunities","openapi":"GET /crm/opportunities/","href":"/api-reference/endpoint/crm-opportunities-list"},{"title":"Get Opportunity","openapi":"GET /crm/opportunities/{opportunity_id}/","href":"/api-reference/endpoint/crm-opportunity-get"},{"title":"Create Opportunity","openapi":"POST /crm/opportunities/","href":"/api-reference/endpoint/crm-opportunity-create"},{"title":"Update Opportunity","openapi":"PATCH /crm/opportunities/{opportunity_id}/","href":"/api-reference/endpoint/crm-opportunity-update"},{"title":"Delete Opportunity","openapi":"DELETE /crm/opportunities/{opportunity_id}/","href":"/api-reference/endpoint/crm-opportunity-delete"}]},{"group":"Company Settings","pages":[{"title":"Get Account Settings","openapi":"GET /settings/","href":"/api-reference/endpoint/settings-account"},{"title":"Get Company Settings","openapi":"GET /settings/company","href":"/api-reference/endpoint/settings-company-get"},{"title":"Update Company Settings","openapi":"PATCH /settings/company","href":"/api-reference/endpoint/settings-company-update"},{"title":"Delete Company","openapi":"DELETE /settings/company","href":"/api-reference/endpoint/settings-company-delete"},{"title":"Duplicate Company","openapi":"POST /settings/company/duplicate/","href":"/api-reference/endpoint/settings-duplicate"},{"title":"Get Company Billing","openapi":"GET /settings/billing/","href":"/api-reference/endpoint/settings-billing"},{"title":"Get Company Integrations","openapi":"GET /settings/integration/","href":"/api-reference/endpoint/settings-integration"},{"title":"Manage Custom Fields","openapi":"GET /settings/custom-fields/","href":"/api-reference/endpoint/settings-custom-fields"},{"title":"Manage Custom Values","openapi":"GET /settings/custom-values/","href":"/api-reference/endpoint/settings-custom-values"},{"title":"List Company Email Senders","openapi":"GET /settings/company/emails/","href":"/api-reference/endpoint/settings-company-emails"}]},{"group":"Company Staff Management","pages":[{"title":"Invite Staff Member","openapi":"POST /settings/company/invite/","href":"/api-reference/endpoint/settings-invite-create"},{"title":"Cancel Invitation","openapi":"DELETE /settings/company/invite/","href":"/api-reference/endpoint/settings-invite-delete"},{"title":"Update Staff Member","openapi":"PATCH /settings/company/staff/","href":"/api-reference/endpoint/settings-staff-update"},{"title":"Remove Staff Member","openapi":"DELETE /settings/company/staff/","href":"/api-reference/endpoint/settings-staff-delete"}]},{"group":"Company Phone Numbers","pages":[{"title":"List Phone Numbers","openapi":"GET /settings/phone","href":"/api-reference/endpoint/settings-phone-list"},{"title":"Add/Update Phone Number","openapi":"POST /settings/phone","href":"/api-reference/endpoint/settings-phone-create"},{"title":"Assign Agent to Phone Number","openapi":"PATCH /settings/phone","href":"/api-reference/endpoint/settings-phone-assign"}]},{"group":"Email Providers, Domains \u0026 Senders","pages":[{"title":"List Email Providers","openapi":"GET /email/providers/","href":"/api-reference/endpoint/email-providers-list"},{"title":"Connect Email Provider","openapi":"POST /email/providers/","href":"/api-reference/endpoint/email-provider-create"},{"title":"Disconnect Email Provider","openapi":"DELETE /email/providers/{connection_id}/","href":"/api-reference/endpoint/email-provider-delete"},{"title":"List Email Domains","openapi":"GET /email/domains/","href":"/api-reference/endpoint/email-domains-list"},{"title":"Add Email Domain","openapi":"POST /email/domains/","href":"/api-reference/endpoint/email-domain-create"},{"title":"Delete Email Domain","openapi":"DELETE /email/domains/{domain_id}/","href":"/api-reference/endpoint/email-domain-delete"},{"title":"Verify Email Domain","openapi":"POST /email/domains/{domain_id}/verify/","href":"/api-reference/endpoint/email-domain-verify"},{"title":"Get Email Domain Verification Status","openapi":"GET /email/domains/{domain_id}/verify-status/","href":"/api-reference/endpoint/email-domain-verify-status"},{"title":"List Email Senders","openapi":"GET /email/senders/","href":"/api-reference/endpoint/email-senders-list"},{"title":"Create Email Sender","openapi":"POST /email/senders/","href":"/api-reference/endpoint/email-sender-create"},{"title":"Update Email Sender","openapi":"PATCH /email/senders/{sender_id}/","href":"/api-reference/endpoint/email-sender-update"},{"title":"Delete Email Sender","openapi":"DELETE /email/senders/{sender_id}/","href":"/api-reference/endpoint/email-sender-delete"},{"title":"Verify Email Sender","openapi":"POST /email/senders/{sender_id}/verify/","href":"/api-reference/endpoint/email-sender-verify"},{"title":"Get Email Sender Verification Status","openapi":"GET /email/senders/{sender_id}/verify-status/","href":"/api-reference/endpoint/email-sender-verify-status"}]},{"group":"Webhooks","pages":[{"title":"Webhook — voice call completed","openapi":"POST /_reference/webhooks/voice-agent-call-completed","href":"/api-reference/endpoint/webhook-voice-call-completed"}]}]}]},"title":"Create Contact - Aidan","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}