Modify an existing contact in your Quo workspace using the contact’s unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you’re changing.
A unique identifier from an external system that can optionally be supplied when creating a contact. This ID is used to associate the contact with records in other systems and is required for retrieving the contact later via the "List Contacts" endpoint. Ensure the externalId is unique and consistent across systems for accurate cross-referencing.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Quo Docs","colors":{"primary":"#1A6EFF","light":"#1A6EFF","dark":"#1F75FF"},"logo":{"light":"https://mintcdn.com/openphone/J5h7IWaRdhdZDPnt/logo/QuoMediaKit_Logo_Charcoal.svg?fit=max\u0026auto=format\u0026n=J5h7IWaRdhdZDPnt\u0026q=85\u0026s=abc86cec4827546e4471dbbce4cad3d1","dark":"https://mintcdn.com/openphone/J5h7IWaRdhdZDPnt/logo/QuoMediaKit_Logo_White.svg?fit=max\u0026auto=format\u0026n=J5h7IWaRdhdZDPnt\u0026q=85\u0026s=408dd478eb6c53578fcecfb2835989b6"},"favicon":"https://mintcdn.com/openphone/J5h7IWaRdhdZDPnt/favicon.svg?fit=max\u0026auto=format\u0026n=J5h7IWaRdhdZDPnt\u0026q=85\u0026s=9df7a9c76451b287554712312d106336","api":{"examples":{"languages":["curl"]}},"background":{"color":{"light":"#FFFFFF","dark":"#1A1926"}},"navbar":{"links":[{"href":"https://survey.survicate.com/377741a204bdef33/?p=anonymous","label":"Feedback"},{"href":"https://my.quo.com/login","label":"Log in"}],"primary":{"type":"button","label":"Try for free","href":"https://my.quo.com/signup"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/gowithquo","reddit":"https://www.reddit.com/r/quo","instagram":"https://www.instagram.com/gowithquo","x":"https://x.com/gowithquo","youtube":"https://www.youtube.com/@gowithquo"}},"seo":{"metatags":{"canonical":"https://www.quo.com/docs"}},"integrations":{"gtm":{"tagId":"GTM-TXWR783H"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openphone","hasAudioNarration":false,"actualSubdomain":"openphone","customDomains":["www.quo.com"],"gitSource":{"type":"github","owner":"openphone","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad7ac41a1379b4ae57c1643","collectionId":"5b189a33-18cb-440e-9b9a-89cada1d629e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7ac41a1379b4ae57c1643"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad7ac41a1379b4ae57c1643","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Guides","count":141},{"language":"default","tag":"Tasks","count":25},{"language":"default","tag":"Webhooks","count":18},{"language":"default","tag":"Contacts","count":12},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Calls","count":10},{"language":"default","tag":"Getting started","count":9},{"language":"default","tag":"Phone Numbers","count":9},{"language":"default","tag":"Essentials","count":8},{"language":"default","tag":"Quo MCP","count":8}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":[{"filePath":"style.css","content":":root{--primary:26 110 255;--primary-light:26 110 255;--primary-dark:31 117 255;--brand:236 247 72;--tooltip-foreground:255 255 255;--background-light:255 255 255;--background-dark:22 22 26;--gray-50:246 246 247;--gray-100:243 243 244;--gray-200:231 231 232;--gray-300:208 208 209;--gray-400:170 170 171;--gray-500:129 129 130;--gray-600:83 83 84;--gray-700:63 63 64;--gray-800:40 40 44;--gray-900:29 29 33;--gray-950:22 22 26}@font-face{font-family:\"Roobert\";src:url(https://uploads-ssl.webflow.com/6384fdd9fd42380b529fc942/646dce023a43d52740e2f3c8_Roobert-SemiBold.ttf);font-weight:600;font-style:normal}@font-face{font-family:\"Roobert\";src:url(https://uploads-ssl.webflow.com/6384fdd9fd42380b529fc942/646dce02a844c04f2faca171_Roobert-Medium.ttf);font-weight:500;font-style:normal}h1,h2,h3{font-family:\"Roobert\",sans-serif}strong{color:inherit!important}#topbar-cta-button{height:36px}#topbar-cta-button>a>span{background-color:rgb(var(--brand));border-radius:10px}#topbar-cta-button>a>div span,#topbar-cta-button>a>div svg{color:rgb(var(--gray-950))}#ketch-privacy-settings-link{display:inline-flex;align-items:center;align-self:center;margin-left:auto;font-size:.75rem;line-height:1;color:rgb(var(--gray-500));text-decoration:none;cursor:pointer}#ketch-privacy-settings-link:hover{color:rgb(var(--gray-700));text-decoration:underline}.dark #ketch-privacy-settings-link{color:rgb(var(--gray-400))}.dark #ketch-privacy-settings-link:hover{color:rgb(var(--gray-200))}#unified-changelog-layout{display:none}body:has(#unified-changelog-layout) #sidebar{display:none!important}body:has(#unified-changelog-layout) #content-area{flex:1;min-width:0;width:auto!important;max-width:none;margin-left:0!important;padding-left:0!important}"},{"filePath":"content/banner.css","content":"#banner{background-color:#6439f5;color:#fff}#banner a{color:#fff;text-decoration:underline}#banner a:hover{color:#e0e0e0}"}],"page":{"pagePath":"mdx/api-reference/contacts/update-a-contact-by-id","slug":"/mdx/api-reference/contacts/update-a-contact-by-id","pageMetadata":{"title":"Update a contact by ID","description":"Modify an existing contact in your Quo workspace using the contact's unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you're changing.","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json patch /v1/contacts/{id}","href":"/mdx/api-reference/contacts/update-a-contact-by-id","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Modify an existing contact in your Quo workspace using the contact’s unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you’re changing.\"\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":"Update a contact by ID","description":"Modify an existing contact in your Quo workspace using the contact's unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you're changing.","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json patch /v1/contacts/{id}","href":"/mdx/api-reference/contacts/update-a-contact-by-id","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/openphone/bfef5336a793a8fb/dreamdata-init.js","/docs/_mintlify/custom/openphone/985f183e60b2ee23/ketch-init.js","/docs/_mintlify/custom/openphone/c4f755c32fa06db1/changelog-layout.js"],"openApiReferenceData":{"operation":{"tags":["Contacts"],"summary":"Update a contact by ID","description":"Modify an existing contact in your Quo workspace using the contact's unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you're changing.","operationId":"updateContactById_v1","parameters":["ebb5352f-3b80-4a9d-b2f5-dced1ceae116"],"security":["1330c380-f055-4a04-973b-6f9728206e4b"],"requestBody":"7fae9a41-8e0f-4cd6-8fb8-bcc2ad3fa835","responses":{"200":"a167e0da-4f34-4714-8dcd-178d96bf01f9","400":"f4e7d0b9-f47f-4559-9685-794f610ad583","401":"a617b281-f5d9-4206-8771-c0a61a9d042a","403":"6df304fd-0457-477b-a9c8-38d00a77640f","404":"d29bd376-f79f-483f-b5a1-21b2e7f18944","409":"0c7418cd-ebdb-4c2e-94fc-a5758b84748d","500":"d7ee1dce-14ca-4bc3-b711-e18afb5d3bb9"},"method":"patch","type":"path","servers":["40482e58-5d2f-48ce-8aeb-855cd444bf09"],"path":"/v1/contacts/{id}","baseUrlOptions":["https://api.quo.com"],"title":"Update a contact by ID","codeSamples":[],"requestExampleLanguages":["bash"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ebb5352f-3b80-4a9d-b2f5-dced1ceae116":{"in":"path","name":"id","required":true,"schema":{"description":"The unique identifier of the contact.","examples":["66d0d87e8dc1211467372303"],"type":"string","pattern":"^(.*)$","isRequired":true,"uniqueKey":"","typeLabel":"string"},"example":"66d0d87e8dc1211467372303"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"externalId":{"oneOf":[{"type":"string","description":"A unique identifier from an external system that can optionally be supplied when creating a contact. This ID is used to associate the contact with records in other systems and is required for retrieving the contact later via the \"List Contacts\" endpoint. Ensure the `externalId` is unique and consistent across systems for accurate cross-referencing.","maxLength":75,"minLength":1,"example":"664d0db69fcac7cf2e6ec","uniqueKey":"externalId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"externalId.oneOf.1","typeLabel":"null"}],"uniqueKey":"externalId","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","description":"Indicates how the contact was created or where it originated from.","maxLength":75,"minLength":1,"example":"public-api","uniqueKey":"source.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"source.oneOf.1","typeLabel":"null"}],"uniqueKey":"source","typeLabel":"string | null"},"sourceUrl":{"oneOf":[{"type":"string","description":"A link to the contact in the source system.","format":"uri","maxLength":200,"minLength":1,"example":"https://openphone.co/contacts/664d0db69fcac7cf2e6ec","uniqueKey":"sourceUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","uniqueKey":"sourceUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"sourceUrl","typeLabel":"string\u003curi> | null"},"defaultFields":{"type":"object","properties":{"company":{"oneOf":[{"type":"string","description":"The contact's company name.","example":"Quo","uniqueKey":"defaultFields.company.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"defaultFields.company.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultFields.company","typeLabel":"string | null"},"emails":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","description":"The name for the contact's email address.","examples":["company email"],"example":"company email","isRequired":true,"uniqueKey":"defaultFields.emails.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"The contact's email address. Setting this to null removes the email item from the contact. Note that omitting the `emails` array entirely from a PATCH request also removes all of the contact's existing emails, since this endpoint replaces the full list rather than merging into it.","example":"info@openphone.com","isRequired":true,"uniqueKey":"defaultFields.emails.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"defaultFields.emails.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"defaultFields.emails.items.[INDEX].value","typeLabel":"string | null"},"id":{"type":"string","description":"The unique identifier for the contact email field.","examples":["acb123"],"example":"acb123","uniqueKey":"defaultFields.emails.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"defaultFields.emails.items.[INDEX]","typeLabel":"object"},"uniqueKey":"defaultFields.emails","typeLabel":"object[]"},"firstName":{"oneOf":[{"type":"string","description":"The contact's first name.","example":"John","uniqueKey":"defaultFields.firstName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"defaultFields.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultFields.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"The contact's last name.","example":"Doe","uniqueKey":"defaultFields.lastName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"defaultFields.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultFields.lastName","typeLabel":"string | null"},"phoneNumbers":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","description":"The name of the contact's phone number.","examples":["company phone"],"example":"company phone","isRequired":true,"uniqueKey":"defaultFields.phoneNumbers.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"The contact's phone number. Setting this to null removes the phone number item from the contact. Note that omitting the `phoneNumbers` array entirely from a PATCH request also removes all of the contact's existing phone numbers, since this endpoint replaces the full list rather than merging into it.","example":"+15555555555","isRequired":true,"uniqueKey":"defaultFields.phoneNumbers.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"defaultFields.phoneNumbers.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"defaultFields.phoneNumbers.items.[INDEX].value","typeLabel":"string | null"},"id":{"type":"string","description":"The unique identifier of the contact phone number field.","examples":["acb123"],"example":"acb123","uniqueKey":"defaultFields.phoneNumbers.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"defaultFields.phoneNumbers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"defaultFields.phoneNumbers","typeLabel":"object[]"},"role":{"oneOf":[{"type":"string","description":"The contact's role.","example":"Sales","uniqueKey":"defaultFields.role.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"defaultFields.role.oneOf.1","typeLabel":"null"}],"uniqueKey":"defaultFields.role","typeLabel":"string | null"}},"uniqueKey":"defaultFields","typeLabel":"object"},"customFields":{"type":"array","items":{"oneOf":[{"type":"object","required":["value"],"properties":{"value":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"customFields.items.[INDEX].oneOf.0.value.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Value defined for the multi select type custom field.","example":["option1","option2"],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Value defined for the multi select type custom field.","example":["option1","option2"],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.0.value","typeLabel":"string[] | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"customFields.items.[INDEX].oneOf.0.key","typeLabel":"string"},"id":{"type":"string","description":"The unique identifier for the contact custom field.","examples":["66d0d87d534de8fd1c433cec3"],"example":"66d0d87d534de8fd1c433cec3","uniqueKey":"customFields.items.[INDEX].oneOf.0.id","typeLabel":"string"}},"uniqueKey":"customFields.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["value"],"properties":{"value":{"oneOf":[{"type":"string","description":"Value defined for the address, string, or url type custom field.","example":"123 Main St","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.1.value.oneOf.0","typeLabel":"string"},{"type":"null","description":"Value defined for the address, string, or url type custom field.","example":"123 Main St","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.1.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.1.value","typeLabel":"string | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"customFields.items.[INDEX].oneOf.1.key","typeLabel":"string"},"id":{"type":"string","description":"The unique identifier for the contact custom field.","examples":["66d0d87d534de8fd1c433cec3"],"example":"66d0d87d534de8fd1c433cec3","uniqueKey":"customFields.items.[INDEX].oneOf.1.id","typeLabel":"string"}},"uniqueKey":"customFields.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["value"],"properties":{"value":{"oneOf":[{"type":"boolean","description":"Value defined for the boolean type custom field.","example":"false","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.2.value.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Value defined for the boolean type custom field.","example":"false","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.2.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.2.value","typeLabel":"boolean | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"customFields.items.[INDEX].oneOf.2.key","typeLabel":"string"},"id":{"type":"string","description":"The unique identifier for the contact custom field.","examples":["66d0d87d534de8fd1c433cec3"],"example":"66d0d87d534de8fd1c433cec3","uniqueKey":"customFields.items.[INDEX].oneOf.2.id","typeLabel":"string"}},"uniqueKey":"customFields.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["value"],"properties":{"value":{"oneOf":[{"type":"string","description":"Value defined for the date type custom fields.","format":"date-time","example":"2024-09-11T04:00:00.000Z","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.3.value.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Value defined for the date type custom fields.","example":"2024-09-11T04:00:00.000Z","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.3.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.3.value","typeLabel":"string\u003cdate-time> | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"customFields.items.[INDEX].oneOf.3.key","typeLabel":"string"},"id":{"type":"string","description":"The unique identifier for the contact custom field.","examples":["66d0d87d534de8fd1c433cec3"],"example":"66d0d87d534de8fd1c433cec3","uniqueKey":"customFields.items.[INDEX].oneOf.3.id","typeLabel":"string"}},"uniqueKey":"customFields.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["value"],"properties":{"value":{"oneOf":[{"type":"number","description":"Value for the number custom field.","example":"424242","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.4.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Value for the number custom field.","example":"424242","isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.4.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customFields.items.[INDEX].oneOf.4.value","typeLabel":"number | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"customFields.items.[INDEX].oneOf.4.key","typeLabel":"string"},"id":{"type":"string","description":"The unique identifier for the contact custom field.","examples":["66d0d87d534de8fd1c433cec3"],"example":"66d0d87d534de8fd1c433cec3","uniqueKey":"customFields.items.[INDEX].oneOf.4.id","typeLabel":"string"}},"uniqueKey":"customFields.items.[INDEX].oneOf.4","typeLabel":"object"}],"uniqueKey":"customFields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"customFields","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"externalId":"664d0db69fcac7cf2e6ec","source":"public-api","sourceUrl":"https://openphone.co/contacts/664d0db69fcac7cf2e6ec","defaultFields":{"company":"Quo","emails":[{"name":"company email","value":"info@openphone.com","id":"acb123"}],"firstName":"John","lastName":"Doe","phoneNumbers":[{"name":"company phone","value":"+15555555555","id":"acb123"}],"role":"Sales"},"customFields":[{"value":["option1","option2"],"key":"inbound-lead","id":"66d0d87d534de8fd1c433cec3"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"a167e0da-4f34-4714-8dcd-178d96bf01f9":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["id","externalId","source","sourceUrl","defaultFields","customFields","createdAt","updatedAt","createdByUserId"],"properties":{"id":{"description":"The unique identifier of the contact.","examples":["664d0db69fcac7cf2e6ec"],"example":"664d0db69fcac7cf2e6ec","type":"string","pattern":"^(.*)$","isRequired":true,"uniqueKey":"data.id","typeLabel":"string"},"externalId":{"oneOf":[{"type":"string","description":"A unique identifier from an external system that can optionally be supplied when creating a contact. This ID is used to associate the contact with records in other systems and is required for retrieving the contact later via the \"List Contacts\" endpoint. Ensure the `externalId` is unique and consistent across systems for accurate cross-referencing.","maxLength":75,"minLength":1,"example":"664d0db69fcac7cf2e6ec","isRequired":true,"uniqueKey":"data.externalId.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.externalId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.externalId","typeLabel":"string | null"},"source":{"oneOf":[{"type":"string","description":"Indicates how the contact was created or where it originated from.","maxLength":75,"minLength":1,"example":"public-api","isRequired":true,"uniqueKey":"data.source.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.source","typeLabel":"string | null"},"sourceUrl":{"oneOf":[{"type":"string","description":"A link to the contact in the source system.","format":"uri","maxLength":200,"minLength":1,"example":"https://openphone.co/contacts/664d0db69fcac7cf2e6ec","isRequired":true,"uniqueKey":"data.sourceUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","isRequired":true,"uniqueKey":"data.sourceUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.sourceUrl","typeLabel":"string\u003curi> | null"},"defaultFields":{"type":"object","required":["company","emails","firstName","lastName","phoneNumbers","role"],"properties":{"company":{"oneOf":[{"type":"string","description":"The contact's company name.","example":"Quo","isRequired":true,"uniqueKey":"data.defaultFields.company.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.company","typeLabel":"string | null"},"emails":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","description":"The name for the contact's email address.","examples":["company email"],"example":"company email","isRequired":true,"uniqueKey":"data.defaultFields.emails.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"The contact's email address.","example":"abc@example.com","isRequired":true,"uniqueKey":"data.defaultFields.emails.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.emails.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.emails.items.[INDEX].value","typeLabel":"string | null"},"id":{"type":"string","description":"The unique identifier for the contact email field.","examples":["acb123"],"example":"acb123","uniqueKey":"data.defaultFields.emails.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"data.defaultFields.emails.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.defaultFields.emails","typeLabel":"object[]"},"firstName":{"oneOf":[{"type":"string","description":"The contact's first name.","example":"John","isRequired":true,"uniqueKey":"data.defaultFields.firstName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"The contact's last name.","example":"Doe","isRequired":true,"uniqueKey":"data.defaultFields.lastName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.lastName","typeLabel":"string | null"},"phoneNumbers":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string","description":"The name of the contact's phone number.","examples":["company phone"],"example":"company phone","isRequired":true,"uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX].name","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"The contact's phone number.","example":"+12345678901","isRequired":true,"uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX].value","typeLabel":"string | null"},"id":{"type":"string","description":"The unique identifier of the contact phone number field.","examples":["acb123"],"example":"acb123","uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"data.defaultFields.phoneNumbers.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.defaultFields.phoneNumbers","typeLabel":"object[]"},"role":{"oneOf":[{"type":"string","description":"The contact's role.","example":"Sales","isRequired":true,"uniqueKey":"data.defaultFields.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.defaultFields.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.defaultFields.role","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.defaultFields","typeLabel":"object"},"customFields":{"type":"array","items":{"oneOf":[{"type":"object","required":["type","value","name"],"properties":{"name":{"type":"string","description":"The name of the custom contact field. This name is set by users in the Quo interface when the custom field is created.","examples":["Inbound Lead"],"example":"Inbound Lead","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.0.name","typeLabel":"string"},"type":{"type":"string","enum":["multi-select"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.0.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.customFields.items.[INDEX].oneOf.0.value.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Value defined for the multi select type custom field.","example":["option1","option2"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.0.value.oneOf.0","typeLabel":"string[]"},{"type":"null","description":"Value defined for the multi select type custom field.","example":["option1","option2"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.0.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.0.value","typeLabel":"string[] | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"data.customFields.items.[INDEX].oneOf.0.key","typeLabel":"string"}},"uniqueKey":"data.customFields.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["type","value","name"],"properties":{"name":{"type":"string","description":"The name of the custom contact field. This name is set by users in the Quo interface when the custom field is created.","examples":["Inbound Lead"],"example":"Inbound Lead","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.1.name","typeLabel":"string"},"type":{"type":"string","enum":["address","string","url"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.1.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"Value defined for the address, string, or url type custom field.","example":"123 Main St","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.1.value.oneOf.0","typeLabel":"string"},{"type":"null","description":"Value defined for the address, string, or url type custom field.","example":"123 Main St","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.1.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.1.value","typeLabel":"string | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"data.customFields.items.[INDEX].oneOf.1.key","typeLabel":"string"}},"uniqueKey":"data.customFields.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","required":["type","value","name"],"properties":{"name":{"type":"string","description":"The name of the custom contact field. This name is set by users in the Quo interface when the custom field is created.","examples":["Inbound Lead"],"example":"Inbound Lead","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.2.name","typeLabel":"string"},"type":{"type":"string","enum":["boolean"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.2.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"boolean","description":"Value defined for the boolean type custom field.","example":"false","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.2.value.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Value defined for the boolean type custom field.","example":"false","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.2.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.2.value","typeLabel":"boolean | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"data.customFields.items.[INDEX].oneOf.2.key","typeLabel":"string"}},"uniqueKey":"data.customFields.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","required":["type","value","name"],"properties":{"name":{"type":"string","description":"The name of the custom contact field. This name is set by users in the Quo interface when the custom field is created.","examples":["Inbound Lead"],"example":"Inbound Lead","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.3.name","typeLabel":"string"},"type":{"type":"string","enum":["date"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.3.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"string","description":"Value defined for the date type custom fields.","format":"date-time","example":"2024-09-11T04:00:00.000Z","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.3.value.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"Value defined for the date type custom fields.","example":"2024-09-11T04:00:00.000Z","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.3.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.3.value","typeLabel":"string\u003cdate-time> | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"data.customFields.items.[INDEX].oneOf.3.key","typeLabel":"string"}},"uniqueKey":"data.customFields.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","required":["type","value","name"],"properties":{"name":{"type":"string","description":"The name of the custom contact field. This name is set by users in the Quo interface when the custom field is created.","examples":["Inbound Lead"],"example":"Inbound Lead","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.4.name","typeLabel":"string"},"type":{"type":"string","enum":["number"],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.4.type","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"type":"number","description":"Value for the number custom field.","example":"424242","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.4.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Value for the number custom field.","example":"424242","isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.4.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.customFields.items.[INDEX].oneOf.4.value","typeLabel":"number | null"},"key":{"type":"string","description":"The identifying key for contact custom field.","examples":["inbound-lead"],"example":"inbound-lead","uniqueKey":"data.customFields.items.[INDEX].oneOf.4.key","typeLabel":"string"}},"uniqueKey":"data.customFields.items.[INDEX].oneOf.4","typeLabel":"object"}],"uniqueKey":"data.customFields.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.customFields","typeLabel":"object[]"},"createdAt":{"description":"Timestamp of contact creation in ISO 8601 format.","examples":["2022-01-01T00:00:00Z"],"example":"2022-01-01T00:00:00Z","type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"description":"Timestamp of last contact update in ISO 8601 format.","examples":["2022-01-01T00:00:00Z"],"example":"2022-01-01T00:00:00Z","type":"string","format":"date-time","isRequired":true,"uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"createdByUserId":{"description":"The unique identifier of the user who created the contact.","examples":["US123abc"],"example":"US123abc","type":"string","pattern":"^US(.*)$","isRequired":true,"uniqueKey":"data.createdByUserId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"664d0db69fcac7cf2e6ec","externalId":"664d0db69fcac7cf2e6ec","source":"public-api","sourceUrl":"https://openphone.co/contacts/664d0db69fcac7cf2e6ec","defaultFields":{"company":"Quo","emails":[{"name":"company email","value":"abc@example.com","id":"acb123"}],"firstName":"John","lastName":"Doe","phoneNumbers":[{"name":"company phone","value":"+12345678901","id":"acb123"}],"role":"Sales"},"customFields":[{"name":"Inbound Lead","type":"multi-select","value":["option1","option2"],"key":"inbound-lead"}],"createdAt":"2022-01-01T00:00:00Z","updatedAt":"2022-01-01T00:00:00Z","createdByUserId":"US123abc"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f4e7d0b9-f47f-4559-9685-794f610ad583":{"description":"Invalid Custom Field Item","content":{"application/json":{"schema":{"type":"object","required":["message","code","status","docs","title"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"0801400","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"number","const":400,"isRequired":true,"uniqueKey":"status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"title":{"type":"string","const":"Invalid Custom Field Item","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"0801400","status":400,"docs":"https://quo.com/docs","title":"Invalid Custom Field Item","trace":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>","schema":{"type":"\u003cstring>"},"value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a617b281-f5d9-4206-8771-c0a61a9d042a":{"description":"Unauthorized","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message","key"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"key":{"type":"string","const":"Unauthorized","isRequired":true,"uniqueKey":"oneOf.0.error.key","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"oneOf.0.error.trace","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["message","code","status","docs","title"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.message","typeLabel":"string"},"code":{"type":"string","const":"0800401","isRequired":true,"uniqueKey":"oneOf.1.code","typeLabel":"string"},"status":{"type":"number","const":401,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"oneOf.1.docs","typeLabel":"string"},"title":{"type":"string","const":"Unauthorized","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"oneOf.1.trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.1.errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"oneOf.1.errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"oneOf.1.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.errors","typeLabel":"object[]"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","key":"Unauthorized","trace":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6df304fd-0457-477b-a9c8-38d00a77640f":{"description":"Not Phone Number User","content":{"application/json":{"schema":{"type":"object","required":["message","code","status","docs","title","description"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"0801403","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"number","const":403,"isRequired":true,"uniqueKey":"status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"title":{"type":"string","const":"Not Phone Number User","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"description":{"type":"string","const":"Not Phone Number User","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"0801403","status":403,"docs":"https://quo.com/docs","title":"Not Phone Number User","description":"Not Phone Number User","trace":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>","schema":{"type":"\u003cstring>"},"value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d29bd376-f79f-483f-b5a1-21b2e7f18944":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","required":["message","code","status","docs","title"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"0800404","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"number","const":404,"isRequired":true,"uniqueKey":"status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"title":{"type":"string","const":"Not Found","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"0800404","status":404,"docs":"https://quo.com/docs","title":"Not Found","trace":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>","schema":{"type":"\u003cstring>"},"value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"0c7418cd-ebdb-4c2e-94fc-a5758b84748d":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","required":["message","code","status","docs","title"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"0800409","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"number","const":409,"isRequired":true,"uniqueKey":"status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"title":{"type":"string","const":"Conflict","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"0800409","status":409,"docs":"https://quo.com/docs","title":"Conflict","trace":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>","schema":{"type":"\u003cstring>"},"value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d7ee1dce-14ca-4bc3-b711-e18afb5d3bb9":{"description":"Unknown Error","content":{"application/json":{"schema":{"type":"object","required":["message","code","status","docs","title"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"0801500","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"status":{"type":"number","const":500,"isRequired":true,"uniqueKey":"status","typeLabel":"number"},"docs":{"type":"string","const":"https://quo.com/docs","isRequired":true,"uniqueKey":"docs","typeLabel":"string"},"title":{"type":"string","const":"Unknown","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"trace":{"type":"string","uniqueKey":"trace","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["path","message","schema"],"properties":{"path":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"schema":{"type":"object","required":["type"],"properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].schema.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"errors.items.[INDEX].schema","typeLabel":"object"},"value":{"oneOf":[{}],"uniqueKey":"errors.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"0801500","status":500,"docs":"https://quo.com/docs","title":"Unknown","trace":"\u003cstring>","errors":[{"path":"\u003cstring>","message":"\u003cstring>","schema":{"type":"\u003cstring>"},"value":"\u003cunknown>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"1330c380-f055-4a04-973b-6f9728206e4b":{"apiKey":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKey"}}},"servers":{"40482e58-5d2f-48ce-8aeb-855cd444bf09":{"description":"Production server","url":"https://api.quo.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json"},"subdomain":"openphone","siteName":"Quo Docs","title":"Update a contact by ID - Quo Docs","navMaps":{"firstHrefInVersion":{"v1":{"href":"/mdx/api-reference/contacts/update-a-contact-by-id","matchLevel":0},"2026-03-30":{"href":"/2026-03-30/contacts/list-contacts","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T15:44:20.429Z","originalFileLocation":"mdx/api-reference/contacts/update-a-contact-by-id.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=\"Modify an existing contact in your Quo workspace using the contact\u0026#x27;s unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you\u0026#x27;re changing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Quo Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_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=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a contact by ID - Quo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Modify an existing contact in your Quo workspace using the contact\u0026#x27;s unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you\u0026#x27;re changing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Quo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openphone.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Update+a+contact+by+ID\u0026amp;description=Modify+an+existing+contact+in+your+Quo+workspace+using+the+contact%27s+unique+identifier.+This+endpoint+replaces+the+contact+rather+than+merging+into+it%3A+any+defa\u0026amp;theme=06150f3ea9f42b9f9c41c800\u0026amp;signature=0c5fc6ff312b15c915c381559a2bfbc27be6caaf2e8e3ca77cb98507154447f4\">\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=\"Update a contact by ID - Quo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Modify an existing contact in your Quo workspace using the contact\u0026#x27;s unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you\u0026#x27;re changing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openphone.mintlify.app/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Update+a+contact+by+ID\u0026amp;description=Modify+an+existing+contact+in+your+Quo+workspace+using+the+contact%27s+unique+identifier.+This+endpoint+replaces+the+contact+rather+than+merging+into+it%3A+any+defa\u0026amp;theme=06150f3ea9f42b9f9c41c800\u0026amp;signature=0c5fc6ff312b15c915c381559a2bfbc27be6caaf2e8e3ca77cb98507154447f4\">\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=\"/docs/mintlify-assets/_mintlify/favicons/openphone/mVlzOyowZeTm852U/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Quo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A6EFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/mdx/api-reference/contacts/update-a-contact-by-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.quo.com/#organization\",\"name\":\"Quo Docs\",\"url\":\"https://www.quo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openphone/J5h7IWaRdhdZDPnt/logo/QuoMediaKit_Logo_Charcoal.svg?fit=max\u0026auto=format\u0026n=J5h7IWaRdhdZDPnt\u0026q=85\u0026s=abc86cec4827546e4471dbbce4cad3d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.quo.com/docs#website\",\"name\":\"Quo Docs\",\"url\":\"https://www.quo.com/docs\",\"publisher\":{\"@id\":\"https://www.quo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id#webpage\",\"url\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id\",\"name\":\"Update a contact by ID\",\"description\":\"Modify an existing contact in your Quo workspace using the contact's unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you're changing.\",\"dateModified\":\"2026-10-19T15:44:20.429Z\",\"isPartOf\":{\"@id\":\"https://www.quo.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contacts\",\"item\":\"https://www.quo.com/docs/mdx/api-reference/contacts/list-contacts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update a contact by ID\",\"item\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id#apireference\",\"headline\":\"Update a contact by ID\",\"name\":\"Update a contact by ID\",\"description\":\"Modify an existing contact in your Quo workspace using the contact's unique identifier. This endpoint replaces the contact rather than merging into it: any defaultFields.emails, defaultFields.phoneNumbers or customFields you omit from the request body is deleted on the contact. Always send the full set of fields, emails, and phone numbers you want the contact to have, not just the ones you're changing.\",\"url\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id\",\"mainEntityOfPage\":{\"@id\":\"https://www.quo.com/docs/mdx/api-reference/contacts/update-a-contact-by-id#webpage\"},\"dateModified\":\"2026-10-19T15:44:20.429Z\",\"publisher\":{\"@id\":\"https://www.quo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.quo.com/docs#website\"}}]}\u003c/script>","siteName":"Quo Docs","nav":{"global":null,"tabs":[{"tab":"Guides","versions":[{"version":"v1","groups":[{"group":"Getting started","pages":[{"title":"Introduction","icon":"hand-wave","href":"/mdx/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/mdx/api-reference/authentication"},{"title":"Send your first message","icon":"rocket","href":"/mdx/api-reference/send-your-first-message"},{"title":"OpenAPI specification","icon":"file-code","url":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json","href":"/mdx/api-reference/openapi"},{"title":"Quo Experts","url":"https://www.quo.com/experts","icon":"compass","href":"/mdx/quo-experts"}]},{"group":"Essentials","pages":[{"title":"API response codes","icon":"circle-check","href":"/mdx/api-reference/error-codes"},{"title":"Rate limits","icon":"bars-filter","href":"/mdx/api-reference/rate-limits"},{"title":"API pricing","icon":"circle-info","href":"/mdx/pricing-support/pricing-overview"}]},{"group":"Agents","pages":[{"group":"Quo MCP","expanded":false,"pages":[{"title":"Quo MCP","icon":"plug","href":"/mdx/mcp/overview"},{"title":"Connect to Quo MCP","icon":"link","href":"/mdx/mcp/connect"},{"title":"Supported tools","icon":"screwdriver-wrench","href":"/mdx/mcp/tools"},{"title":"Security best practices","icon":"shield-check","href":"/mdx/mcp/security"}]},{"group":"Best practices","expanded":false,"pages":[{"title":"Building with AI LLMs","icon":"wand-magic-sparkles","href":"/mdx/guides/building-with-ai-llms"}]}]},{"group":"Guides \u0026 resources","pages":[{"group":"Contacts","expanded":false,"pages":[{"title":"External contacts","icon":"address-card","href":"/mdx/guides/contacts"},{"title":"Sync your contacts","icon":"person","href":"/mdx/guides/sync-contacts"}]}]},{"group":"Calls","pages":[{"title":"Get recordings for a call","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/call-recordings/{callId}","href":"/mdx/api-reference/calls/get-recordings-for-a-call"},{"title":"List calls","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/calls","href":"/mdx/api-reference/calls/list-calls"},{"title":"Get a call by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/calls/{callId}","href":"/mdx/api-reference/calls/get-a-call-by-id"},{"title":"Get a summary for a call","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/call-summaries/{callId}","href":"/mdx/api-reference/calls/get-a-summary-for-a-call"},{"title":"Get a transcription for a call","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/call-transcripts/{id}","href":"/mdx/api-reference/calls/get-a-transcription-for-a-call"},{"title":"Get a voicemail for a call","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/call-voicemails/{callId}","href":"/mdx/api-reference/calls/get-a-voicemail-for-a-call"}]},{"group":"Contact Custom Fields","pages":[{"title":"Get contact custom fields","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/contact-custom-fields","href":"/mdx/api-reference/contact-custom-fields/get-contact-custom-fields"}]},{"group":"Contacts","pages":[{"title":"List contacts","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/contacts","href":"/mdx/api-reference/contacts/list-contacts"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/contacts","href":"/mdx/api-reference/contacts/create-a-contact"},{"title":"Get a contact by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/contacts/{id}","href":"/mdx/api-reference/contacts/get-a-contact-by-id"},{"title":"Delete a contact","description":"Delete a contact by its unique identifier.","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json delete /v1/contacts/{id}","href":"/mdx/api-reference/contacts/delete-a-contact"},{"title":"Update a contact by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json patch /v1/contacts/{id}","href":"/mdx/api-reference/contacts/update-a-contact-by-id"}]},{"group":"Conversations","pages":[{"title":"List conversations","description":"Fetch a paginated list of conversations of Quo conversations. Can be filtered by user and/or phone numbers. Defaults to all conversations in the Quo organization. Results are returned in descending order based on the most recent conversation.","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/conversations","href":"/mdx/api-reference/conversations/list-conversations"},{"title":"Mark conversation as read","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/conversations/{conversationId}/mark-as-read","href":"/mdx/api-reference/conversations/mark-conversation-as-read"},{"title":"Mark conversation as done","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/conversations/{conversationId}/mark-as-done","href":"/mdx/api-reference/conversations/mark-conversation-as-done"},{"title":"Mark conversation as open","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/conversations/{conversationId}/mark-as-open","href":"/mdx/api-reference/conversations/mark-conversation-as-open"}]},{"group":"Messages","pages":[{"title":"List messages","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/messages","href":"/mdx/api-reference/messages/list-messages"},{"title":"Send a text message","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/messages","href":"/mdx/api-reference/messages/send-a-text-message"},{"title":"Get a message by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/messages/{id}","href":"/mdx/api-reference/messages/get-a-message-by-id"}]},{"group":"Phone Numbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/phone-numbers","href":"/mdx/api-reference/phone-numbers/list-phone-numbers"},{"title":"Get a phone number by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/phone-numbers/{phoneNumberId}","href":"/mdx/api-reference/phone-numbers/get-a-phone-number-by-id"}]},{"group":"Tasks","pages":[{"title":"List tasks","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/tasks","href":"/mdx/api-reference/tasks/list-tasks"},{"title":"Create a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks","href":"/mdx/api-reference/tasks/create-a-task"},{"title":"Gets a task by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/tasks/{taskId}","href":"/mdx/api-reference/tasks/gets-a-task-by-id"},{"title":"Update a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json put /v1/tasks/{taskId}","href":"/mdx/api-reference/tasks/update-a-task"},{"title":"Delete a task by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json delete /v1/tasks/{taskId}","href":"/mdx/api-reference/tasks/delete-a-task-by-id"},{"title":"Complete a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/complete","href":"/mdx/api-reference/tasks/complete-a-task"},{"title":"Link a task to a conversation","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/link-conversation","href":"/mdx/api-reference/tasks/link-a-task-to-a-conversation"},{"title":"Unlink a task from a conversation","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/unlink-conversation","href":"/mdx/api-reference/tasks/unlink-a-task-from-a-conversation"},{"title":"Reopen a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/reopen","href":"/mdx/api-reference/tasks/reopen-a-task"},{"title":"Assign a user to a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/assign","href":"/mdx/api-reference/tasks/assign-a-user-to-a-task"},{"title":"Unassign a user from a task","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/unassign","href":"/mdx/api-reference/tasks/unassign-a-user-from-a-task"},{"title":"Change a task's due date","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/change-due-date","href":"/mdx/api-reference/tasks/change-a-tasks-due-date"},{"title":"Remove a task's due date","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/tasks/{taskId}/remove-due-date","href":"/mdx/api-reference/tasks/remove-a-tasks-due-date"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/users","href":"/mdx/api-reference/users/list-users"},{"title":"Get a user by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/users/{userId}","href":"/mdx/api-reference/users/get-a-user-by-id"}]},{"group":"Webhooks","pages":[{"title":"Lists all webhooks","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/webhooks","href":"/mdx/api-reference/webhooks/lists-all-webhooks"},{"title":"Get a webhook by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/webhooks/{id}","href":"/mdx/api-reference/webhooks/get-a-webhook-by-id"},{"title":"Delete a webhook by ID","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json delete /v1/webhooks/{id}","href":"/mdx/api-reference/webhooks/delete-a-webhook-by-id"},{"title":"Create a new webhook for messages","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/webhooks/messages","href":"/mdx/api-reference/webhooks/create-a-new-webhook-for-messages"},{"title":"Create a new webhook for calls","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/webhooks/calls","href":"/mdx/api-reference/webhooks/create-a-new-webhook-for-calls"},{"title":"Create a new webhook for call summaries","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/webhooks/call-summaries","href":"/mdx/api-reference/webhooks/create-a-new-webhook-for-call-summaries"},{"title":"Create a new webhook for call transcripts","deprecated":null,"version":null,"openapi":"https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json post /v1/webhooks/call-transcripts","href":"/mdx/api-reference/webhooks/create-a-new-webhook-for-call-transcripts"}]}]},{"version":"2026-03-30","pages":[{"title":"2026-03-30","href":"/2026-03-30/contacts/list-contacts"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Update a contact by ID - Quo Docs","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bg4Z7D_G.js","utils-Biz734EK.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6F9YHs6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BoJjY_VP.js","snippetPresets-CnZ-mOFh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DC_SB2pp.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BYKtOiIP.js","shallow-COAac_UD.js","getApiPlaygroundDisplay-BV4Viqi2.js","CodeSnippet-DDgW-JXl.js","CodeSnippets-CP1LpNhG.js","Page-BeiUfucV.js","getPastedJson-Cvgvbfmv.js","icon-D-H368xH.js","MethodPill-CXSxH1VW.js","DuplicateIcon-JcbBzF1x.js","createIcon-BDt_aHZM.js","DynamicMarkdown-DO1Fz7ar.js","SectionHeading-mwKBArs3.js","axios-vUo_bRtp.js","Markdown-C3KUTGJN.js","clsx-C6CAjViH.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C3vb5JQZ.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C8Hisf3g.js"]}