Phone numbers in E.164 format. If provided, replaces all existing phone numbers.
Required array length: 1 - 20 elements
Example:
["+33612345678", "+33698765432"]
customFields
object
Custom field values keyed by the custom field slug (the stable, immutable identifier returned by GET /custom-fields). Only provided keys are updated; omit to leave existing values untouched. Custom fields must already exist for the team. For backwards compatibility this endpoint also accepts keys matching the custom field name, but this fallback is deprecated and will be removed in a future release — migrate your integrations to use slugs.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Skipcall Public Documentation","colors":{"primary":"#09AA77","light":"#3ABC93","dark":"#09AA77"},"logo":{"light":"https://mintcdn.com/skipcall/LX1aEnS2aRGTqWnO/logo/light.svg?fit=max\u0026auto=format\u0026n=LX1aEnS2aRGTqWnO\u0026q=85\u0026s=3f4c9f09f82d4f9f493b0aaf97d5cdd3","dark":"https://mintcdn.com/skipcall/LX1aEnS2aRGTqWnO/logo/dark.svg?fit=max\u0026auto=format\u0026n=LX1aEnS2aRGTqWnO\u0026q=85\u0026s=6dba03aa048d17bdc4c0777a8f31c8bb","href":"https://docs.skipcall.app"},"favicon":"https://mintcdn.com/skipcall/LX1aEnS2aRGTqWnO/favicon.svg?fit=max\u0026auto=format\u0026n=LX1aEnS2aRGTqWnO\u0026q=85\u0026s=61a068a8d0e1aa1e43dbc9c3a2689359","appearance":{"default":"system"},"navbar":{"links":[{"href":"mailto:support@skipcall.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.skipcall.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/get-skipcall"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Site internet","icon":"earth-africa","href":"https://skipcall.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"skipcall","hasAudioNarration":false,"actualSubdomain":"skipcall","customDomains":["docs.skipcall.app"],"gitSource":{"type":"github","owner":"skipcall","repo":"skipcall-publicapi-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac8e449cda84f472b9952ea","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":46},{"language":"default","tag":"Available endpoints","count":43},{"language":"default","tag":"Calls","count":9},{"language":"default","tag":"Sequences","count":8},{"language":"default","tag":"Contacts","count":5},{"language":"default","tag":"Custom Fields","count":5},{"language":"default","tag":"Tags","count":5},{"language":"default","tag":"Statistics","count":3},{"language":"default","tag":"Workspaces","count":3},{"language":"default","tag":"Get started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/contacts/update-a-contact","slug":"/api-reference/contacts/update-a-contact","pageMetadata":{"title":"Update a contact","description":"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json patch /v1/contacts/{id}","href":"/api-reference/contacts/update-a-contact","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: \"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\"\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","description":"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json patch /v1/contacts/{id}","href":"/api-reference/contacts/update-a-contact","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.","operationId":"ContactController_update","parameters":["496b6777-ddff-4878-ba79-7d44a3ba04e1"],"requestBody":"bdc7d903-221a-49dc-beaa-e85d5e754baf","responses":{"200":"52e913d0-e96d-4428-ad11-9d829fb56621","400":"5c832b7c-7bad-4839-9787-f6530abd7eed","401":"2ac72b0c-73e0-47a3-92a0-319acf132403","403":"ca253b8d-a1b1-49e1-ac11-828553b35d4c","404":"aa3b0d06-9935-47a4-b9bd-9bfd4f83d77f"},"security":["ba201822-f887-46c1-9dc9-9c059f0579c1"],"summary":"Update a contact","tags":["Contacts"],"method":"patch","type":"path","servers":["03bb8250-aca8-432f-8e34-ae6faa0ef819"],"path":"/v1/contacts/{id}","baseUrlOptions":["https://api-public.skipcall.app"],"title":"Update a contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"496b6777-ddff-4878-ba79-7d44a3ba04e1":{"name":"id","required":true,"in":"path","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"type":"string","description":"First name of the contact","example":"John","minLength":1,"maxLength":100,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact","example":"Doe","minLength":1,"maxLength":100,"uniqueKey":"lastName","typeLabel":"string"},"email":{"type":"string","description":"Email address of the contact","example":"john.doe@example.com","uniqueKey":"email","typeLabel":"string"},"company":{"type":"string","description":"Company name","example":"Acme Inc.","maxLength":200,"uniqueKey":"company","typeLabel":"string"},"city":{"type":"string","description":"City","example":"Paris","maxLength":200,"uniqueKey":"city","typeLabel":"string"},"country":{"type":"string","description":"Country","example":"France","maxLength":200,"uniqueKey":"country","typeLabel":"string"},"url":{"type":"string","description":"Website URL","example":"https://example.com","uniqueKey":"url","typeLabel":"string"},"linkedinUrl":{"type":"string","description":"LinkedIn profile URL","example":"https://linkedin.com/in/johndoe","uniqueKey":"linkedinUrl","typeLabel":"string"},"linkedinSalesUrl":{"type":"string","description":"LinkedIn Sales Navigator URL","example":"https://linkedin.com/sales/people/johndoe","uniqueKey":"linkedinSalesUrl","typeLabel":"string"},"role":{"type":"string","description":"Role / job title","example":"CTO","maxLength":200,"uniqueKey":"role","typeLabel":"string"},"allowPhoneCalls":{"type":"boolean","description":"Whether the contact accepts phone calls","example":true,"uniqueKey":"allowPhoneCalls","typeLabel":"boolean"},"phoneNumbers":{"description":"Phone numbers in E.164 format. If provided, replaces all existing phone numbers.","example":["+33612345678","+33698765432"],"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","uniqueKey":"phoneNumbers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"phoneNumbers","typeLabel":"string[]"},"customFields":{"type":"object","description":"Custom field values keyed by the custom field **slug** (the stable, immutable identifier returned by GET /custom-fields). Only provided keys are updated; omit to leave existing values untouched. Custom fields must already exist for the team. For backwards compatibility this endpoint also accepts keys matching the custom field **name**, but this fallback is deprecated and will be removed in a future release — migrate your integrations to use slugs.","example":{"industry":"Technology","team_size":"50-100"},"additionalProperties":{"type":"string","uniqueKey":"customFields.additionalProperties","typeLabel":"string"},"uniqueKey":"customFields","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"firstName":"John","lastName":"Doe","email":"john.doe@example.com","company":"Acme Inc.","city":"Paris","country":"France","url":"https://example.com","linkedinUrl":"https://linkedin.com/in/johndoe","linkedinSalesUrl":"https://linkedin.com/sales/people/johndoe","role":"CTO","allowPhoneCalls":true,"phoneNumbers":["+33612345678","+33698765432"],"customFields":{"industry":"Technology","team_size":"50-100"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"52e913d0-e96d-4428-ad11-9d829fb56621":{"description":"The updated contact","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"firstName":{"type":"string","example":"John","isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","example":"Doe","isRequired":true,"uniqueKey":"lastName","typeLabel":"string"},"allowPhoneCalls":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"allowPhoneCalls","typeLabel":"boolean"},"callCount":{"type":"number","example":5,"isRequired":true,"uniqueKey":"callCount","typeLabel":"number"},"teamId":{"type":"string","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"teamId","typeLabel":"string"},"phoneNumbers":{"example":["+33612345678"],"type":"array","items":{"type":"string","uniqueKey":"phoneNumbers.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"phoneNumbers","typeLabel":"string[]"},"customFields":{"type":"object","example":{"Industry":"Technology","Size":"50-100"},"additionalProperties":{"type":"string","uniqueKey":"customFields.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"customFields","typeLabel":"object"},"createdAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"},"lastModificationSource":{"type":"string","enum":["SKIPCALL","API"],"isRequired":true,"uniqueKey":"lastModificationSource","typeLabel":"enum\u003cstring>"},"email":{"oneOf":[{"type":"object","example":"john.doe@example.com","uniqueKey":"email.oneOf.0","typeLabel":"object"},{"type":"null","example":"john.doe@example.com","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"object | null"},"company":{"oneOf":[{"type":"object","example":"Acme Inc.","uniqueKey":"company.oneOf.0","typeLabel":"object"},{"type":"null","example":"Acme Inc.","uniqueKey":"company.oneOf.1","typeLabel":"null"}],"uniqueKey":"company","typeLabel":"object | null"},"city":{"oneOf":[{"type":"object","example":"Paris","uniqueKey":"city.oneOf.0","typeLabel":"object"},{"type":"null","example":"Paris","uniqueKey":"city.oneOf.1","typeLabel":"null"}],"uniqueKey":"city","typeLabel":"object | null"},"country":{"oneOf":[{"type":"object","example":"France","uniqueKey":"country.oneOf.0","typeLabel":"object"},{"type":"null","example":"France","uniqueKey":"country.oneOf.1","typeLabel":"null"}],"uniqueKey":"country","typeLabel":"object | null"},"url":{"oneOf":[{"type":"object","example":"https://example.com","uniqueKey":"url.oneOf.0","typeLabel":"object"},{"type":"null","example":"https://example.com","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"object | null"},"linkedinUrl":{"oneOf":[{"type":"object","example":"https://linkedin.com/in/johndoe","uniqueKey":"linkedinUrl.oneOf.0","typeLabel":"object"},{"type":"null","example":"https://linkedin.com/in/johndoe","uniqueKey":"linkedinUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"linkedinUrl","typeLabel":"object | null"},"linkedinSalesUrl":{"oneOf":[{"type":"object","example":"https://linkedin.com/sales/people/johndoe","uniqueKey":"linkedinSalesUrl.oneOf.0","typeLabel":"object"},{"type":"null","example":"https://linkedin.com/sales/people/johndoe","uniqueKey":"linkedinSalesUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"linkedinSalesUrl","typeLabel":"object | null"},"role":{"oneOf":[{"type":"object","example":"CTO","uniqueKey":"role.oneOf.0","typeLabel":"object"},{"type":"null","example":"CTO","uniqueKey":"role.oneOf.1","typeLabel":"null"}],"uniqueKey":"role","typeLabel":"object | null"},"lastCallAt":{"oneOf":[{"format":"date-time","type":"string","uniqueKey":"lastCallAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"format":"date-time","type":"null","uniqueKey":"lastCallAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastCallAt","typeLabel":"string\u003cdate-time> | null"}},"required":["id","firstName","lastName","allowPhoneCalls","callCount","teamId","phoneNumbers","customFields","createdAt","updatedAt","lastModificationSource"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"550e8400-e29b-41d4-a716-446655440000","firstName":"John","lastName":"Doe","allowPhoneCalls":true,"callCount":5,"teamId":"550e8400-e29b-41d4-a716-446655440000","phoneNumbers":["+33612345678"],"customFields":{"Industry":"Technology","Size":"50-100"},"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","lastModificationSource":"SKIPCALL","email":"john.doe@example.com","company":"Acme Inc.","city":"Paris","country":"France","url":"https://example.com","linkedinUrl":"https://linkedin.com/in/johndoe","linkedinSalesUrl":"https://linkedin.com/sales/people/johndoe","role":"CTO","lastCallAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"5c832b7c-7bad-4839-9787-f6530abd7eed":{"description":"Invalid input data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2ac72b0c-73e0-47a3-92a0-319acf132403":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"UNAUTHORIZED","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Invalid or revoked API key","uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":401,"uniqueKey":"error.status","typeLabel":"number"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHORIZED","message":"Invalid or revoked API key","status":401}}}},"exampleType":"generated"}},"exampleType":"generated"},"ca253b8d-a1b1-49e1-ac11-828553b35d4c":{"description":"Subscription required or plan not eligible","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"PLAN_NOT_ELIGIBLE","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"API access requires INTERMÉDIAIRE or EXPERT plan","uniqueKey":"error.message","typeLabel":"string"},"status":{"type":"number","example":403,"uniqueKey":"error.status","typeLabel":"number"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"PLAN_NOT_ELIGIBLE","message":"API access requires INTERMÉDIAIRE or EXPERT plan","status":403}}}},"exampleType":"generated"}},"exampleType":"generated"},"aa3b0d06-9935-47a4-b9bd-9bfd4f83d77f":{"description":"Contact not found or outside API key scope","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ba201822-f887-46c1-9dc9-9c059f0579c1":{"ApiKey":{"scheme":"bearer","bearerFormat":"API Key","type":"http","description":"Enter your API Key (sk_live_xxx or sk_test_xxx)","scopes":[],"schemeName":"ApiKey"}}},"servers":{"03bb8250-aca8-432f-8e34-ae6faa0ef819":{"url":"https://api-public.skipcall.app","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"API Key","type":"http","description":"Enter your API Key (sk_live_xxx or sk_test_xxx)","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Enter your API Key (sk_live_xxx or sk_test_xxx)","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"https://api-public.skipcall.app/docs-json"},"subdomain":"skipcall","siteName":"Skipcall Public Documentation","title":"Update a contact - Skipcall Public Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-09T12:55:42.587Z","originalFileLocation":"api-reference/contacts/update-a-contact.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Skipcall Public Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_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/skipcall/ZFRYY9r0RwQyXSME/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a contact - Skipcall Public Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Skipcall Public Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.skipcall.app/api-reference/contacts/update-a-contact\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://skipcall.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Update+a+contact\u0026amp;description=Updates+an+existing+contact.+Only+provided+fields+will+be+updated.+Returns+404+if+the+contact+is+in+a+workspace+outside+the+API+key+scope.\u0026amp;theme=302211511ecd6db247074e77\u0026amp;signature=8c670db904b03b8444bbc54ddc848582cd5a08680df9f2fbb1a769831b30c96a\">\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 - Skipcall Public Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skipcall.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Update+a+contact\u0026amp;description=Updates+an+existing+contact.+Only+provided+fields+will+be+updated.+Returns+404+if+the+contact+is+in+a+workspace+outside+the+API+key+scope.\u0026amp;theme=302211511ecd6db247074e77\u0026amp;signature=8c670db904b03b8444bbc54ddc848582cd5a08680df9f2fbb1a769831b30c96a\">\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/skipcall/ZFRYY9r0RwQyXSME/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Skipcall Public Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#09AA77\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.skipcall.app/api-reference/contacts/update-a-contact\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contacts/update-a-contact.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.skipcall.app/#organization\",\"name\":\"Skipcall Public Documentation\",\"url\":\"https://docs.skipcall.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/skipcall/LX1aEnS2aRGTqWnO/logo/light.svg?fit=max\u0026auto=format\u0026n=LX1aEnS2aRGTqWnO\u0026q=85\u0026s=3f4c9f09f82d4f9f493b0aaf97d5cdd3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.skipcall.app#website\",\"name\":\"Skipcall Public Documentation\",\"url\":\"https://docs.skipcall.app\",\"publisher\":{\"@id\":\"https://docs.skipcall.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact#webpage\",\"url\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact\",\"name\":\"Update a contact\",\"description\":\"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\",\"dateModified\":\"2026-10-09T12:55:42.587Z\",\"isPartOf\":{\"@id\":\"https://docs.skipcall.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Available endpoints\",\"item\":\"https://docs.skipcall.app/api-reference/health/health-check-endpoint\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Contacts\",\"item\":\"https://docs.skipcall.app/api-reference/contacts/list-contacts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update a contact\",\"item\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact#apireference\",\"headline\":\"Update a contact\",\"name\":\"Update a contact\",\"description\":\"Updates an existing contact. Only provided fields will be updated. Returns 404 if the contact is in a workspace outside the API key scope.\",\"url\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact\",\"mainEntityOfPage\":{\"@id\":\"https://docs.skipcall.app/api-reference/contacts/update-a-contact#webpage\"},\"dateModified\":\"2026-10-09T12:55:42.587Z\",\"publisher\":{\"@id\":\"https://docs.skipcall.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.skipcall.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Skipcall Public Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Skipcall Public Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/contacts/update-a-contact.md","siteName":"Skipcall Public Documentation","nav":{"global":{"anchors":[{"anchor":"Site internet","icon":"earth-africa","href":"https://skipcall.io"}]},"tabs":[{"tab":"API reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"group":"Get started","pages":[{"title":"Authentication","href":"/api-reference/api-documentation/authentication"},{"title":"Rate limiting","href":"/api-reference/api-documentation/rate-limiting"},{"title":"Paginating API results","hidden":true,"href":"/api-reference/api-documentation/untitled-page"}]},{"group":"Available endpoints","expanded":true,"pages":[{"group":"Health","pages":[{"title":"Health check endpoint","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/health","href":"/api-reference/health/health-check-endpoint"}]},{"group":"Authentication","pages":[{"title":"Get current API key info","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/me","href":"/api-reference/authentication/get-current-api-key-info"}]},{"group":"Contacts","pages":[{"title":"List contacts","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/contacts","href":"/api-reference/contacts/create-a-contact"},{"title":"Get a contact","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/contacts/{id}","href":"/api-reference/contacts/get-a-contact"},{"title":"Delete a contact","description":"Soft-deletes a contact. The contact can no longer be retrieved after deletion. Returns 404 if the contact is in a workspace outside the API key scope.","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/contacts/{id}","href":"/api-reference/contacts/delete-a-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json patch /v1/contacts/{id}","href":"/api-reference/contacts/update-a-contact"}]},{"group":"Calls","pages":[{"title":"List calls","description":"Returns a paginated list of calls scoped to the workspaces accessible by the API key. Use the `workspaceIds` query parameter to narrow results to a subset of those workspaces.","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls","href":"/api-reference/calls/list-calls"},{"title":"Get a call","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls/{id}","href":"/api-reference/calls/get-a-call"},{"title":"Get call recording","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls/{id}/recording","href":"/api-reference/calls/get-call-recording"},{"title":"Delete a call recording","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/calls/{id}/recording","href":"/api-reference/calls/delete-a-call-recording"},{"title":"Stream the audio of a call recording","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls/{id}/recording/audio","href":"/api-reference/calls/stream-the-audio-of-a-call-recording"},{"title":"Get call transcription","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls/{id}/transcription","href":"/api-reference/calls/get-call-transcription"},{"title":"Delete a call transcription","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/calls/{id}/transcription","href":"/api-reference/calls/delete-a-call-transcription"},{"title":"Delete a call summary","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/calls/{id}/summary","href":"/api-reference/calls/delete-a-call-summary"},{"title":"Stream the audio of the dropped voicemail clip for a call","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/calls/{id}/voicemail-drop/audio","href":"/api-reference/calls/stream-the-audio-of-the-dropped-voicemail-clip-for-a-call"}]},{"group":"Users","pages":[{"title":"List organization users","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/users","href":"/api-reference/users/list-organization-users"}]},{"group":"Sequences","pages":[{"title":"List sequences","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/sequences","href":"/api-reference/sequences/list-sequences"},{"title":"Create a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/sequences","href":"/api-reference/sequences/create-a-sequence"},{"title":"Get a sequence by ID","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/sequences/{id}","href":"/api-reference/sequences/get-a-sequence-by-id"},{"title":"List contacts of a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/sequences/{id}/contacts","href":"/api-reference/sequences/list-contacts-of-a-sequence"},{"title":"Add contacts to a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/sequences/{id}/contacts","href":"/api-reference/sequences/add-contacts-to-a-sequence"},{"title":"Remove contacts from a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/sequences/{id}/contacts","href":"/api-reference/sequences/remove-contacts-from-a-sequence"},{"title":"Archive a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/sequences/{id}/archive","href":"/api-reference/sequences/archive-a-sequence"},{"title":"Unarchive a sequence","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/sequences/{id}/unarchive","href":"/api-reference/sequences/unarchive-a-sequence"}]},{"group":"Statistics","pages":[{"title":"Get call duration statistics","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/stats/calls","href":"/api-reference/statistics/get-call-duration-statistics"},{"title":"Get call status distribution","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/stats/status-repartition","href":"/api-reference/statistics/get-call-status-distribution"},{"title":"Get tag distribution","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/stats/tag-repartition","href":"/api-reference/statistics/get-tag-distribution"}]},{"group":"Teams (deprecated — use /workspaces)","pages":[{"title":"List teams accessible by this API key","deprecated":true,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/teams","href":"/api-reference/teams-deprecated-—-use-workspaces/list-teams-accessible-by-this-api-key"},{"title":"Get stats aggregated by team","deprecated":true,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/teams/stats","href":"/api-reference/teams-deprecated-—-use-workspaces/get-stats-aggregated-by-team"}]},{"group":"Workspaces","pages":[{"title":"List workspaces accessible by this API key","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/workspaces","href":"/api-reference/workspaces/list-workspaces-accessible-by-this-api-key"},{"title":"Get stats aggregated by workspace","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/workspaces/stats","href":"/api-reference/workspaces/get-stats-aggregated-by-workspace"},{"title":"List members of a workspace","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/workspaces/{id}/members","href":"/api-reference/workspaces/list-members-of-a-workspace"}]},{"group":"Tags","pages":[{"title":"List tags","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/tags","href":"/api-reference/tags/list-tags"},{"title":"Create a tag","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/tags","href":"/api-reference/tags/create-a-tag"},{"title":"Get a tag by ID","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/tags/{id}","href":"/api-reference/tags/get-a-tag-by-id"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Update a tag","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json patch /v1/tags/{id}","href":"/api-reference/tags/update-a-tag"}]},{"group":"Custom Fields","pages":[{"title":"List custom fields","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/custom-fields","href":"/api-reference/custom-fields/list-custom-fields"},{"title":"Create a custom field","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/custom-fields","href":"/api-reference/custom-fields/create-a-custom-field"},{"title":"Get a custom field","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json get /v1/custom-fields/{id}","href":"/api-reference/custom-fields/get-a-custom-field"},{"title":"Delete a custom field","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json delete /v1/custom-fields/{id}","href":"/api-reference/custom-fields/delete-a-custom-field"},{"title":"Update a custom field","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json patch /v1/custom-fields/{id}","href":"/api-reference/custom-fields/update-a-custom-field"}]}]}]}]},"basePath":"","title":"Update a contact - Skipcall Public Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}