Target workspace id (from GET /v1/workspaces). Required for multi-workspace API keys to designate which workspace to write to; omit for single-workspace keys, where it is resolved automatically. Must be within the API key scope.
Body
application/json
firstName
string
required
First name of the contact
Required string length: 1 - 100
Example:
"John"
lastName
string
required
Last name of the contact
Required string length: 1 - 100
Example:
"Doe"
phoneNumbers
string[]
required
Phone numbers in E.164 format (e.g., +33612345678)
Required array length: 1 - 20 elements
Example:
["+33612345678"]
email
string
Email address of the contact
Example:
"john.doe@example.com"
company
string
Company name
Maximum string length: 200
Example:
"Acme Inc."
city
string
City
Maximum string length: 200
Example:
"Paris"
country
string
Country
Maximum string length: 200
Example:
"France"
url
string
Website URL
Example:
"https://example.com"
linkedinUrl
string
LinkedIn profile URL
Example:
"https://linkedin.com/in/johndoe"
linkedinSalesUrl
string
LinkedIn Sales Navigator URL
Example:
"https://linkedin.com/sales/people/johndoe"
role
string
Role / job title
Maximum string length: 200
Example:
"CTO"
allowPhoneCalls
boolean
Whether the contact accepts phone calls. Defaults to true.
Example:
true
customFields
object
Custom field values keyed by the custom field slug (the stable, immutable identifier returned by GET /custom-fields). Custom fields must already exist for the team (use the Custom Fields endpoints to create them). 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.4160","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/contacts/create-a-contact","slug":"/api-reference/contacts/create-a-contact","pageMetadata":{"title":"Create a contact","description":"Creates a new contact in your organization","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/contacts","href":"/api-reference/contacts/create-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: \"Creates a new contact in your organization\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a contact","description":"Creates a new contact in your organization","deprecated":null,"version":null,"openapi":"https://api-public.skipcall.app/docs-json post /v1/contacts","href":"/api-reference/contacts/create-a-contact","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Creates a new contact in your organization","operationId":"ContactController_create","parameters":["f0242577-57f5-4b8d-b775-fa4158501026"],"requestBody":"6994ca8f-7d71-4e9e-b5da-044d64b9180a","responses":{"201":"55ef531c-3f95-4035-a3ec-07b8c5d9b658","400":"38b7e190-0e2a-46e6-8e9f-5ab6182a7e3d","401":"cfa7e648-f8a2-4d5e-8d50-9c0a99500b92","403":"92e12580-f97e-45bf-89c4-7ce894ee13fb"},"security":["a5de5f56-0522-4bf2-a167-106c2985cc05"],"summary":"Create a contact","tags":["Contacts"],"method":"post","type":"path","servers":["03bb8250-aca8-432f-8e34-ae6faa0ef819"],"path":"/v1/contacts","baseUrlOptions":["https://api-public.skipcall.app"],"title":"Create a contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f0242577-57f5-4b8d-b775-fa4158501026":{"name":"x-workspace-id","in":"header","description":"Target workspace id (from `GET /v1/workspaces`). Required for multi-workspace API keys to designate which workspace to write to; omit for single-workspace keys, where it is resolved automatically. Must be within the API key scope.","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Target workspace id (from `GET /v1/workspaces`). Required for multi-workspace API keys to designate which workspace to write to; omit for single-workspace keys, where it is resolved automatically. Must be within the API key scope.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"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,"isRequired":true,"uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name of the contact","example":"Doe","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"lastName","typeLabel":"string"},"phoneNumbers":{"description":"Phone numbers in E.164 format (e.g., +33612345678)","example":["+33612345678"],"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","uniqueKey":"phoneNumbers.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"phoneNumbers","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. Defaults to true.","example":true,"uniqueKey":"allowPhoneCalls","typeLabel":"boolean"},"customFields":{"type":"object","description":"Custom field values keyed by the custom field **slug** (the stable, immutable identifier returned by GET /custom-fields). Custom fields must already exist for the team (use the Custom Fields endpoints to create them). 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"}},"required":["firstName","lastName","phoneNumbers"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"firstName":"John","lastName":"Doe","phoneNumbers":["+33612345678"],"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,"customFields":{"industry":"Technology","team_size":"50-100"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"55ef531c-3f95-4035-a3ec-07b8c5d9b658":{"description":"The created 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"},"38b7e190-0e2a-46e6-8e9f-5ab6182a7e3d":{"description":"Invalid input data","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"cfa7e648-f8a2-4d5e-8d50-9c0a99500b92":{"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"},"92e12580-f97e-45bf-89c4-7ce894ee13fb":{"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"}},"security":{"a5de5f56-0522-4bf2-a167-106c2985cc05":{"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":"Create a contact - Skipcall Public Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-09T12:55:42.557Z","originalFileLocation":"api-reference/contacts/create-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=\"Creates a new contact in your organization\">\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=\"Create a contact - Skipcall Public Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new contact in your organization\">\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/create-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=Create+a+contact\u0026amp;description=Creates+a+new+contact+in+your+organization\u0026amp;theme=302211511ecd6db247074e77\u0026amp;signature=2e894623ba76271d6234671783ea8b38d0fd0f1ab21e7296b907a07fed3a4213\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a contact - Skipcall Public Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new contact in your organization\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skipcall.mintlify.site/_mintlify/api/og/v2?division=Contacts\u0026amp;title=Create+a+contact\u0026amp;description=Creates+a+new+contact+in+your+organization\u0026amp;theme=302211511ecd6db247074e77\u0026amp;signature=2e894623ba76271d6234671783ea8b38d0fd0f1ab21e7296b907a07fed3a4213\">\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/create-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/create-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/create-a-contact#webpage\",\"url\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact\",\"name\":\"Create a contact\",\"description\":\"Creates a new contact in your organization\",\"dateModified\":\"2026-10-09T12:55:42.557Z\",\"isPartOf\":{\"@id\":\"https://docs.skipcall.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.skipcall.app/api-reference/contacts/create-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\":\"Create a contact\",\"item\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact#apireference\",\"headline\":\"Create a contact\",\"name\":\"Create a contact\",\"description\":\"Creates a new contact in your organization\",\"url\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact\",\"mainEntityOfPage\":{\"@id\":\"https://docs.skipcall.app/api-reference/contacts/create-a-contact#webpage\"},\"dateModified\":\"2026-10-09T12:55:42.557Z\",\"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/create-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","description":"Returns a paginated list of contacts 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/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","description":"Returns a single contact by ID. 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 get /v1/contacts/{id}","href":"/api-reference/contacts/get-a-contact"},{"title":"Delete a contact","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","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":"Create a contact - Skipcall Public Documentation","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","Page-CWFqNdGh.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}