Creates or updates a CRM person record using a unique attribute to find an existing match.
If a person with the same value for matchingAttribute is found → it is updated and 200 is returned.
If no match is found → a new person is created and 201 is returned.
Matching attribute
The matchingAttribute query parameter specifies which field to use for the lookup. It can be any standard or custom attribute slug on the people object.
PUT /v2/crm/people?matchingAttribute=emailPUT /v2/crm/people?matchingAttribute=phone_numberPUT /v2/crm/people?matchingAttribute=my_custom_attribute
Email matching
When matchingAttribute is email or emails, the lookup checks both the primary email and all secondary email addresses, so a person is found regardless of which email slot holds the value.
Other attributes
All other standard attributes (e.g. phone_number) and custom attributes are matched using exact equality.
Use case
Assert is the recommended endpoint for bulk imports and sync jobs. Send your full person payload and let the API decide whether to create or update — no need to pre-check for duplicates.
Attribute slug to use when searching for an existing person. Can be any standard or custom attribute slug.
Use email (or emails) to match against the person's primary email and secondary emails.
All other attributes are matched using an exact equality check.
Body
application/json
firstName
string | null
First name. Required if lastName is not provided.
Example:
"Jane"
lastName
string | null
Last name. Required if firstName is not provided.
Example:
"Doe"
salutation
string | null
emails
string<email>[] | null
List of email addresses. The first entry is the primary (matching) email.
Example:
["jane.doe@acme.com"]
jobTitle
string | null
description
string | null
phoneNumber
string | null
primaryLocation
string | null
avatarUrl
string | null
companyId
string | null
contactOwnerMemberId
integer | null
The workspace member responsible for this person, as on POST /crm/people.
socials
object
Hide child attributes
socials.linkedin
string | null
socials.twitter
string | null
socials.facebook
string | null
socials.instagram
string | null
Response
Updated — a person with the matching email was found and updated
success
boolean
Example:
true
status
integer
Example:
200
person
object
A CRM person record.
Hide child attributes
person.id
string<uuid>
required
Unique identifier for the person record.
Example:
"b2c3d4e5-f6a7-8901-bcde-f23456789012"
person.firstName
string | null
required
First name.
Example:
"Jane"
person.lastName
string | null
required
Last name.
Example:
"Doe"
person.salutation
string | null
required
Salutation or title (e.g. Mr, Ms, Dr).
Example:
"Ms"
person.emails
string<email>[]
required
List of email addresses. The first entry is the primary email.
Example:
["jane.doe@acme.com"]
person.jobTitle
string | null
required
Job title or role.
Example:
"Head of Product"
person.description
string | null
required
Free-text description or notes about the person.
Example:
"Key decision-maker at Acme Corp."
person.phoneNumber
string | null
required
Primary phone number.
Example:
"+4930123456789"
person.primaryLocation
string | null
required
Primary location or city.
Example:
"Berlin, Germany"
person.avatarUrl
string | null
required
URL of the person's avatar image.
Example:
null
person.company
object | null
required
The company this person is associated with, if any.
Hide child attributes
person.company.id
string<uuid>
person.company.name
string | null
person.company.domain
string | null
person.contactOwnerMemberId
integer | null
required
The memberId (from GET /organizations/users) of the workspace member responsible for this person, the value the requests take under the same key. null when nobody is responsible or that member has left the workspace.
Example:
4821
person.socials
object
required
Social profile links.
Hide child attributes
person.socials.linkedin
string | null
Example:
"https://linkedin.com/in/janedoe"
person.socials.twitter
string | null
Example:
null
person.socials.facebook
string | null
Example:
null
person.socials.instagram
string | null
Example:
null
person.customAttributes
object
required
Key/value pairs for custom attributes defined on the people object.
Example:
{}
person.createdAt
string<date-time>
required
ISO 8601 timestamp when the record was created.
Example:
"2025-01-15T09:00:00+00:00"
person.updatedAt
string<date-time>
required
ISO 8601 timestamp when the record was last updated.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Zeeg Developer Hub","description":"Zeeg Developer Hub: REST API reference, guides, and webhooks for building scheduling, booking, and AI-agent integrations on the Zeeg platform.","colors":{"primary":"#6C63FF","light":"#8B83FF","dark":"#4F46E5"},"logo":"https://mintcdn.com/zeeg/9voKLLkajreclhp4/images/Zeeglogo(Original).svg?fit=max\u0026auto=format\u0026n=9voKLLkajreclhp4\u0026q=85\u0026s=321632804eda4b3cff044941f9ccadda","favicon":"https://mintcdn.com/zeeg/9voKLLkajreclhp4/images/favicon.ico?fit=max\u0026auto=format\u0026n=9voKLLkajreclhp4\u0026q=85\u0026s=ee885974552f141091cdd615c5c15345","api":{"openapi":"openapi.yaml","params":{"expanded":"all"},"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.zeeg.me/v2"}},"appearance":{"default":"system"},"background":{"decoration":"gradient","color":{"dark":"#0f1117"}},"navbar":{"links":[{"href":"https://app.zeeg.me","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.zeeg.me/account/settings/api-access"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/zeeg","x":"https://www.twitter.com/zeeg_me","youtube":"https://www.youtube.com/@zeeg_me","instagram":"https://www.instagram.com/zeeg.me"},"links":[{"header":"Product","items":[{"label":"Pricing","href":"https://zeeg.me/en/pricing"},{"label":"Help Center","href":"https://zeeg.me/en/help"},{"label":"System Status","href":"https://status.zeeg.me"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://zeeg.me/en/legal/terms"},{"label":"Privacy Policy","href":"https://zeeg.me/en/legal/privacy"},{"label":"Imprint","href":"https://zeeg.me/en/legal/imprint"}]}]},"search":{"prompt":"Search endpoints, guides, and more..."},"seo":{"metatags":{"og:site_name":"Zeeg Developer Hub","og:type":"website","og:locale":"en_US","og:url":"https://developer.zeeg.me","twitter:card":"summary_large_image","twitter:site":"@zeeg_me","author":"Zeeg","robots":"index, follow","googlebot":"index, follow"},"indexing":"all"},"fonts":{"family":"Inter"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"section","latex":false},"integrations":{"gtm":{"tagId":"GTM-5XJGGJP"}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"The page you're looking for doesn't exist. Try the [API Reference](/api/workspaces-teams/check-logged-in-user) or [Quickstart](/quickstart)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zeeg","hasAudioNarration":false,"actualSubdomain":"zeeg","customDomains":["developer.zeeg.me"],"gitSource":{"type":"github","owner":"zeeg","repo":"api-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01a0ee0abeee4b6ea228b5","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":216},{"language":"default","tag":"CRM","count":27},{"language":"default","tag":"Scheduling Pages","count":19},{"language":"default","tag":"Availability Schedule","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Routing Forms","count":12},{"language":"default","tag":"Workspaces \u0026 Teams","count":12},{"language":"default","tag":"Forms","count":8},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Objects","count":7}],"searchSettings":{"maxResults":10}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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/crm/update-a-crm-person","slug":"/api/crm/update-a-crm-person","pageMetadata":{"title":"Assert a CRM Person","description":"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs","openapi":"PUT /crm/people","href":"/api/crm/update-a-crm-person"},"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: \"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Creates or updates a CRM person record using a unique attribute to find an existing match.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`If a person with the same value for `,_jsx(_components.code,{children:`matchingAttribute`}),` is found → it is `,_jsx(_components.strong,{children:`updated`}),` and `,_jsx(_components.code,{children:`200`}),` is returned.`]}),`\n`,_jsxs(_components.li,{children:[`If no match is found → a new person is `,_jsx(_components.strong,{children:`created`}),` and `,_jsx(_components.code,{children:`201`}),` is returned.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`matching-attribute`,children:`Matching attribute`}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`matchingAttribute`}),` query parameter specifies which field to use for the lookup. It can be `,_jsx(_components.strong,{children:`any standard or custom attribute slug`}),` on the people object.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`PUT /v2/crm/people?matchingAttribute=email`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`PUT /v2/crm/people?matchingAttribute=phone_number`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`PUT /v2/crm/people?matchingAttribute=my_custom_attribute`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`email-matching`,children:`Email matching`}),`\n`,_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`matchingAttribute`}),` is `,_jsx(_components.code,{children:`email`}),` or `,_jsx(_components.code,{children:`emails`}),`, the lookup checks both the primary email and all secondary email addresses, so a person is found regardless of which email slot holds the value.`]}),`\n`,_jsx(Heading,{level:`3`,id:`other-attributes`,children:`Other attributes`}),`\n`,_jsxs(_components.p,{children:[`All other standard attributes (e.g. `,_jsx(_components.code,{children:`phone_number`}),`) and custom attributes are matched using exact equality.`]}),`\n`,_jsx(Heading,{level:`2`,id:`use-case`,children:`Use case`}),`\n`,_jsx(_components.p,{children:`Assert is the recommended endpoint for bulk imports and sync jobs. Send your full person payload and let the API decide whether to create or update — no need to pre-check for duplicates.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"firstName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Jane\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"emails\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane.doe@acme.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"jobTitle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Head of Product\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"primaryLocation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Berlin, Germany\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"socials\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"linkedin\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://linkedin.com/in/janedoe\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Assert a CRM Person","description":"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs","openapi":"PUT /crm/people","href":"/api/crm/update-a-crm-person"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Matching attribute","slug":"matching-attribute","depth":2,"children":[{"title":"Email matching","slug":"email-matching","depth":3,"children":[]},{"title":"Other attributes","slug":"other-attributes","depth":3,"children":[]}]},{"title":"Use case","slug":"use-case","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Assert a CRM person (upsert)","tags":["CRM - People"],"operationId":"put-crm-people","description":"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs","security":["24ad335a-c77e-4e49-9649-769bc100008f"],"parameters":["ab29d219-45bd-40f2-8f75-d6560283519b"],"requestBody":"c813c41f-7277-4451-8675-65c7614675c1","responses":{"200":"02bdf91f-a803-4fbc-9f08-827544e19c3c","201":"28316080-02a6-4f1e-8b13-516af1127abc","401":"9f41ee9b-ad11-4ab1-a649-b77348b4ea03","403":"6cf6a1a0-eb07-4268-bacf-11d2a6505e85","422":"1261d510-98b6-47be-8e19-1faea10125d2"},"method":"put","type":"path","servers":["dcff1800-0618-4dfd-b78a-57d290938438"],"path":"/crm/people","baseUrlOptions":["https://api.zeeg.me/v2"],"title":"Assert a CRM person (upsert)","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"ab29d219-45bd-40f2-8f75-d6560283519b":{"name":"matchingAttribute","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"Attribute slug to use when searching for an existing person. Can be any standard or custom attribute slug.\nUse `email` (or `emails`) to match against the person's primary email and secondary emails.\nAll other attributes are matched using an exact equality check.","uniqueKey":"","typeLabel":"string"},"description":"Attribute slug to use when searching for an existing person. Can be any standard or custom attribute slug.\nUse `email` (or `emails`) to match against the person's primary email and secondary emails.\nAll other attributes are matched using an exact equality check.","example":"email"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name. Required if `lastName` is not provided.","example":"Jane","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name. Required if `lastName` is not provided.","example":"Jane","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name. Required if `firstName` is not provided.","example":"Doe","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name. Required if `firstName` is not provided.","example":"Doe","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"salutation":{"oneOf":[{"type":"string","uniqueKey":"salutation.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"salutation.oneOf.1","typeLabel":"null"}],"uniqueKey":"salutation","typeLabel":"string | null"},"emails":{"oneOf":[{"type":"array","description":"List of email addresses. The first entry is the primary (matching) email.","items":{"type":"string","format":"email","uniqueKey":"emails.oneOf.0.items.[INDEX]","typeLabel":"string\u003cemail>"},"example":["jane.doe@acme.com"],"uniqueKey":"emails.oneOf.0","typeLabel":"string\u003cemail>[]"},{"type":"null","description":"List of email addresses. The first entry is the primary (matching) email.","items":{"type":"string","format":"email"},"example":["jane.doe@acme.com"],"uniqueKey":"emails.oneOf.1","typeLabel":"null"}],"uniqueKey":"emails","typeLabel":"string\u003cemail>[] | null"},"jobTitle":{"oneOf":[{"type":"string","uniqueKey":"jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"jobTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"jobTitle","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"phoneNumber":{"oneOf":[{"type":"string","uniqueKey":"phoneNumber.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"phoneNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"phoneNumber","typeLabel":"string | null"},"primaryLocation":{"oneOf":[{"type":"string","uniqueKey":"primaryLocation.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"primaryLocation.oneOf.1","typeLabel":"null"}],"uniqueKey":"primaryLocation","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","uniqueKey":"avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"avatarUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"avatarUrl","typeLabel":"string | null"},"companyId":{"oneOf":[{"type":"string","uniqueKey":"companyId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"companyId.oneOf.1","typeLabel":"null"}],"uniqueKey":"companyId","typeLabel":"string | null"},"contactOwnerMemberId":{"oneOf":[{"type":"integer","description":"The workspace member responsible for this person, as on `POST /crm/people`.","uniqueKey":"contactOwnerMemberId.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The workspace member responsible for this person, as on `POST /crm/people`.","uniqueKey":"contactOwnerMemberId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contactOwnerMemberId","typeLabel":"integer | null"},"socials":{"type":"object","properties":{"linkedin":{"oneOf":[{"type":"string","uniqueKey":"socials.linkedin.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"socials.linkedin.oneOf.1","typeLabel":"null"}],"uniqueKey":"socials.linkedin","typeLabel":"string | null"},"twitter":{"oneOf":[{"type":"string","uniqueKey":"socials.twitter.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"socials.twitter.oneOf.1","typeLabel":"null"}],"uniqueKey":"socials.twitter","typeLabel":"string | null"},"facebook":{"oneOf":[{"type":"string","uniqueKey":"socials.facebook.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"socials.facebook.oneOf.1","typeLabel":"null"}],"uniqueKey":"socials.facebook","typeLabel":"string | null"},"instagram":{"oneOf":[{"type":"string","uniqueKey":"socials.instagram.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"socials.instagram.oneOf.1","typeLabel":"null"}],"uniqueKey":"socials.instagram","typeLabel":"string | null"}},"uniqueKey":"socials","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"firstName":"Jane","lastName":"Doe","salutation":"\u003cstring>","emails":["jane.doe@acme.com"],"jobTitle":"\u003cstring>","description":"\u003cstring>","phoneNumber":"\u003cstring>","primaryLocation":"\u003cstring>","avatarUrl":"\u003cstring>","companyId":"\u003cstring>","contactOwnerMemberId":123,"socials":{"linkedin":"\u003cstring>","twitter":"\u003cstring>","facebook":"\u003cstring>","instagram":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"02bdf91f-a803-4fbc-9f08-827544e19c3c":{"description":"Updated — a person with the matching email was found and updated","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"uniqueKey":"success","typeLabel":"boolean"},"status":{"type":"integer","example":200,"uniqueKey":"status","typeLabel":"integer"},"person":{"type":"object","description":"A CRM person record.","required":["id","firstName","lastName","salutation","emails","jobTitle","description","phoneNumber","primaryLocation","avatarUrl","company","contactOwnerMemberId","socials","customAttributes","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the person record.","example":"b2c3d4e5-f6a7-8901-bcde-f23456789012","isRequired":true,"uniqueKey":"person.id","typeLabel":"string\u003cuuid>"},"firstName":{"oneOf":[{"type":"string","description":"First name.","example":"Jane","isRequired":true,"uniqueKey":"person.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name.","example":"Jane","isRequired":true,"uniqueKey":"person.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name.","example":"Doe","isRequired":true,"uniqueKey":"person.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name.","example":"Doe","isRequired":true,"uniqueKey":"person.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.lastName","typeLabel":"string | null"},"salutation":{"oneOf":[{"type":"string","description":"Salutation or title (e.g. Mr, Ms, Dr).","example":"Ms","isRequired":true,"uniqueKey":"person.salutation.oneOf.0","typeLabel":"string"},{"type":"null","description":"Salutation or title (e.g. Mr, Ms, Dr).","example":"Ms","isRequired":true,"uniqueKey":"person.salutation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.salutation","typeLabel":"string | null"},"emails":{"type":"array","description":"List of email addresses. The first entry is the primary email.","items":{"type":"string","format":"email","uniqueKey":"person.emails.items.[INDEX]","typeLabel":"string\u003cemail>"},"example":["jane.doe@acme.com"],"isRequired":true,"uniqueKey":"person.emails","typeLabel":"string\u003cemail>[]"},"jobTitle":{"oneOf":[{"type":"string","description":"Job title or role.","example":"Head of Product","isRequired":true,"uniqueKey":"person.jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job title or role.","example":"Head of Product","isRequired":true,"uniqueKey":"person.jobTitle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.jobTitle","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Free-text description or notes about the person.","example":"Key decision-maker at Acme Corp.","isRequired":true,"uniqueKey":"person.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text description or notes about the person.","example":"Key decision-maker at Acme Corp.","isRequired":true,"uniqueKey":"person.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.description","typeLabel":"string | null"},"phoneNumber":{"oneOf":[{"type":"string","description":"Primary phone number.","example":"+4930123456789","isRequired":true,"uniqueKey":"person.phoneNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary phone number.","example":"+4930123456789","isRequired":true,"uniqueKey":"person.phoneNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.phoneNumber","typeLabel":"string | null"},"primaryLocation":{"oneOf":[{"type":"string","description":"Primary location or city.","example":"Berlin, Germany","isRequired":true,"uniqueKey":"person.primaryLocation.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary location or city.","example":"Berlin, Germany","isRequired":true,"uniqueKey":"person.primaryLocation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.primaryLocation","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","description":"URL of the person's avatar image.","example":null,"isRequired":true,"uniqueKey":"person.avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the person's avatar image.","example":null,"isRequired":true,"uniqueKey":"person.avatarUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.avatarUrl","typeLabel":"string | null"},"company":{"oneOf":[{"type":"object","description":"The company this person is associated with, if any.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"person.company.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","uniqueKey":"person.company.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"person.company.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.company.oneOf.0.name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","uniqueKey":"person.company.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"person.company.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.company.oneOf.0.domain","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"person.company.oneOf.0","typeLabel":"object"},{"type":"null","description":"The company this person is associated with, if any.","properties":{"id":{"type":"string","format":"uuid"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"person.company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.company","typeLabel":"object | null"},"contactOwnerMemberId":{"oneOf":[{"type":"integer","description":"The `memberId` (from `GET /organizations/users`) of the workspace member responsible for this person, the value the requests take under the same key. `null` when nobody is responsible or that member has left the workspace.","example":4821,"isRequired":true,"uniqueKey":"person.contactOwnerMemberId.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The `memberId` (from `GET /organizations/users`) of the workspace member responsible for this person, the value the requests take under the same key. `null` when nobody is responsible or that member has left the workspace.","example":4821,"isRequired":true,"uniqueKey":"person.contactOwnerMemberId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.contactOwnerMemberId","typeLabel":"integer | null"},"socials":{"type":"object","description":"Social profile links.","properties":{"linkedin":{"oneOf":[{"type":"string","example":"https://linkedin.com/in/janedoe","uniqueKey":"person.socials.linkedin.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://linkedin.com/in/janedoe","uniqueKey":"person.socials.linkedin.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.linkedin","typeLabel":"string | null"},"twitter":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.twitter.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.twitter.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.twitter","typeLabel":"string | null"},"facebook":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.facebook.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.facebook.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.facebook","typeLabel":"string | null"},"instagram":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.instagram.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.instagram.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.instagram","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"person.socials","typeLabel":"object"},"customAttributes":{"type":"object","description":"Key/value pairs for custom attributes defined on the people object.","additionalProperties":true,"example":{},"isRequired":true,"uniqueKey":"person.customAttributes","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the record was created.","example":"2025-01-15T09:00:00+00:00","isRequired":true,"uniqueKey":"person.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the record was last updated.","example":"2025-06-01T12:00:00+00:00","isRequired":true,"uniqueKey":"person.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"person","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"status":200,"person":{"id":"b2c3d4e5-f6a7-8901-bcde-f23456789012","firstName":"Jane","lastName":"Doe","salutation":"Ms","emails":["jane.doe@acme.com"],"jobTitle":"Head of Product","description":"Key decision-maker at Acme Corp.","phoneNumber":"+4930123456789","primaryLocation":"Berlin, Germany","avatarUrl":null,"company":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","domain":"\u003cstring>"},"contactOwnerMemberId":4821,"socials":{"linkedin":"https://linkedin.com/in/janedoe","twitter":null,"facebook":null,"instagram":null},"customAttributes":{},"createdAt":"2025-01-15T09:00:00+00:00","updatedAt":"2025-06-01T12:00:00+00:00"}}}},"exampleType":"generated"}},"exampleType":"generated"},"28316080-02a6-4f1e-8b13-516af1127abc":{"description":"Created — no person with the matching email was found; a new one was created","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"uniqueKey":"success","typeLabel":"boolean"},"status":{"type":"integer","example":201,"uniqueKey":"status","typeLabel":"integer"},"person":{"type":"object","description":"A CRM person record.","required":["id","firstName","lastName","salutation","emails","jobTitle","description","phoneNumber","primaryLocation","avatarUrl","company","contactOwnerMemberId","socials","customAttributes","createdAt","updatedAt"],"properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the person record.","example":"b2c3d4e5-f6a7-8901-bcde-f23456789012","isRequired":true,"uniqueKey":"person.id","typeLabel":"string\u003cuuid>"},"firstName":{"oneOf":[{"type":"string","description":"First name.","example":"Jane","isRequired":true,"uniqueKey":"person.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name.","example":"Jane","isRequired":true,"uniqueKey":"person.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name.","example":"Doe","isRequired":true,"uniqueKey":"person.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name.","example":"Doe","isRequired":true,"uniqueKey":"person.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.lastName","typeLabel":"string | null"},"salutation":{"oneOf":[{"type":"string","description":"Salutation or title (e.g. Mr, Ms, Dr).","example":"Ms","isRequired":true,"uniqueKey":"person.salutation.oneOf.0","typeLabel":"string"},{"type":"null","description":"Salutation or title (e.g. Mr, Ms, Dr).","example":"Ms","isRequired":true,"uniqueKey":"person.salutation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.salutation","typeLabel":"string | null"},"emails":{"type":"array","description":"List of email addresses. The first entry is the primary email.","items":{"type":"string","format":"email","uniqueKey":"person.emails.items.[INDEX]","typeLabel":"string\u003cemail>"},"example":["jane.doe@acme.com"],"isRequired":true,"uniqueKey":"person.emails","typeLabel":"string\u003cemail>[]"},"jobTitle":{"oneOf":[{"type":"string","description":"Job title or role.","example":"Head of Product","isRequired":true,"uniqueKey":"person.jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job title or role.","example":"Head of Product","isRequired":true,"uniqueKey":"person.jobTitle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.jobTitle","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Free-text description or notes about the person.","example":"Key decision-maker at Acme Corp.","isRequired":true,"uniqueKey":"person.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Free-text description or notes about the person.","example":"Key decision-maker at Acme Corp.","isRequired":true,"uniqueKey":"person.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.description","typeLabel":"string | null"},"phoneNumber":{"oneOf":[{"type":"string","description":"Primary phone number.","example":"+4930123456789","isRequired":true,"uniqueKey":"person.phoneNumber.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary phone number.","example":"+4930123456789","isRequired":true,"uniqueKey":"person.phoneNumber.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.phoneNumber","typeLabel":"string | null"},"primaryLocation":{"oneOf":[{"type":"string","description":"Primary location or city.","example":"Berlin, Germany","isRequired":true,"uniqueKey":"person.primaryLocation.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary location or city.","example":"Berlin, Germany","isRequired":true,"uniqueKey":"person.primaryLocation.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.primaryLocation","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","description":"URL of the person's avatar image.","example":null,"isRequired":true,"uniqueKey":"person.avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the person's avatar image.","example":null,"isRequired":true,"uniqueKey":"person.avatarUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.avatarUrl","typeLabel":"string | null"},"company":{"oneOf":[{"type":"object","description":"The company this person is associated with, if any.","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"person.company.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","uniqueKey":"person.company.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"person.company.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.company.oneOf.0.name","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","uniqueKey":"person.company.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"person.company.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.company.oneOf.0.domain","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"person.company.oneOf.0","typeLabel":"object"},{"type":"null","description":"The company this person is associated with, if any.","properties":{"id":{"type":"string","format":"uuid"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]}},"isRequired":true,"uniqueKey":"person.company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.company","typeLabel":"object | null"},"contactOwnerMemberId":{"oneOf":[{"type":"integer","description":"The `memberId` (from `GET /organizations/users`) of the workspace member responsible for this person, the value the requests take under the same key. `null` when nobody is responsible or that member has left the workspace.","example":4821,"isRequired":true,"uniqueKey":"person.contactOwnerMemberId.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The `memberId` (from `GET /organizations/users`) of the workspace member responsible for this person, the value the requests take under the same key. `null` when nobody is responsible or that member has left the workspace.","example":4821,"isRequired":true,"uniqueKey":"person.contactOwnerMemberId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"person.contactOwnerMemberId","typeLabel":"integer | null"},"socials":{"type":"object","description":"Social profile links.","properties":{"linkedin":{"oneOf":[{"type":"string","example":"https://linkedin.com/in/janedoe","uniqueKey":"person.socials.linkedin.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://linkedin.com/in/janedoe","uniqueKey":"person.socials.linkedin.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.linkedin","typeLabel":"string | null"},"twitter":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.twitter.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.twitter.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.twitter","typeLabel":"string | null"},"facebook":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.facebook.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.facebook.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.facebook","typeLabel":"string | null"},"instagram":{"oneOf":[{"type":"string","example":null,"uniqueKey":"person.socials.instagram.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"uniqueKey":"person.socials.instagram.oneOf.1","typeLabel":"null"}],"uniqueKey":"person.socials.instagram","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"person.socials","typeLabel":"object"},"customAttributes":{"type":"object","description":"Key/value pairs for custom attributes defined on the people object.","additionalProperties":true,"example":{},"isRequired":true,"uniqueKey":"person.customAttributes","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the record was created.","example":"2025-01-15T09:00:00+00:00","isRequired":true,"uniqueKey":"person.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the record was last updated.","example":"2025-06-01T12:00:00+00:00","isRequired":true,"uniqueKey":"person.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"person","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"status":201,"person":{"id":"b2c3d4e5-f6a7-8901-bcde-f23456789012","firstName":"Jane","lastName":"Doe","salutation":"Ms","emails":["jane.doe@acme.com"],"jobTitle":"Head of Product","description":"Key decision-maker at Acme Corp.","phoneNumber":"+4930123456789","primaryLocation":"Berlin, Germany","avatarUrl":null,"company":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","domain":"\u003cstring>"},"contactOwnerMemberId":4821,"socials":{"linkedin":"https://linkedin.com/in/janedoe","twitter":null,"facebook":null,"instagram":null},"customAttributes":{},"createdAt":"2025-01-15T09:00:00+00:00","updatedAt":"2025-06-01T12:00:00+00:00"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9f41ee9b-ad11-4ab1-a649-b77348b4ea03":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Unauthenticated.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Unauthenticated":{"title":"Unauthenticated","value":{"message":"Unauthenticated."}}},"exampleType":"examples"}},"exampleType":"examples"},"6cf6a1a0-eb07-4268-bacf-11d2a6505e85":{"description":"Forbidden — missing scope or CRM not enabled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","uniqueKey":"error.message","typeLabel":"string"},"error_id":{"type":"string","uniqueKey":"error.error_id","typeLabel":"string"},"required_scopes":{"type":"array","items":{"type":"string","uniqueKey":"error.required_scopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error.required_scopes","typeLabel":"string[]"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Missing scope":{"title":"Missing scope","value":{"error":{"type":"insufficient_scope","message":"Your token is missing the required scope: crm:write.","error_id":"922d7c94-09d6-442a-8067-bb19e272b9bf","required_scopes":["crm:write"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"1261d510-98b6-47be-8e19-1faea10125d2":{"description":"Unprocessable Entity. A field is invalid, or the owner member id names no member of this workspace.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"oneOf.0.message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"oneOf.0.errors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"oneOf.0.errors","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"oneOf.1.success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"oneOf.1.message","typeLabel":"string"},"status":{"type":"integer","example":422,"uniqueKey":"oneOf.1.status","typeLabel":"integer"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Invalid field":{"title":"Invalid field","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}},"Owner outside the workspace":{"title":"Owner outside the workspace","value":{"success":false,"message":"One of the selected members is not in this workspace.","status":422}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"24ad335a-c77e-4e49-9649-769bc100008f":{"bearer":{"type":"http","scheme":"bearer","description":"","scopes":[],"schemeName":"bearer"}}},"servers":{"dcff1800-0618-4dfd-b78a-57d290938438":{"url":"https://api.zeeg.me/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"zeeg","siteName":"Zeeg Developer Hub","title":"Assert a CRM Person - Zeeg Developer Hub","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-11T13:33:54.851Z","gitLastModified":"2026-06-11T13:33:37.000Z","originalFileLocation":"api/crm/update-a-crm-person.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zeeg Developer Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_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/zeeg/ghjkS0QJHhQPDpab/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Assert a CRM Person - Zeeg Developer Hub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zeeg Developer Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.zeeg.me/api/crm/update-a-crm-person\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zeeg.mintlify.site/_mintlify/api/og/v2?division=People\u0026amp;title=Assert+a+CRM+Person\u0026amp;description=Create+or+update+a+CRM+person+via+the+Zeeg+CRM+API%2C+matching+on+any+standard+or+custom+attribute+slug+to+upsert+contacts+in+bulk+imports+and+sync+jobs\u0026amp;theme=902e11371c50c4af37ea8b4f\u0026amp;signature=c9fedfa3bd47bc61a117f0e49fc6041196b005913deb0e777ab0fcdf40c9bb16\">\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=\"Assert a CRM Person - Zeeg Developer Hub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zeeg.mintlify.site/_mintlify/api/og/v2?division=People\u0026amp;title=Assert+a+CRM+Person\u0026amp;description=Create+or+update+a+CRM+person+via+the+Zeeg+CRM+API%2C+matching+on+any+standard+or+custom+attribute+slug+to+upsert+contacts+in+bulk+imports+and+sync+jobs\u0026amp;theme=902e11371c50c4af37ea8b4f\u0026amp;signature=c9fedfa3bd47bc61a117f0e49fc6041196b005913deb0e777ab0fcdf40c9bb16\">\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/zeeg/ghjkS0QJHhQPDpab/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zeeg Developer Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C63FF\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"author\" content=\"Zeeg\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.zeeg.me/api/crm/update-a-crm-person\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/crm/update-a-crm-person.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.zeeg.me/#organization\",\"name\":\"Zeeg Developer Hub\",\"url\":\"https://developer.zeeg.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zeeg/9voKLLkajreclhp4/images/Zeeglogo(Original).svg?fit=max\u0026auto=format\u0026n=9voKLLkajreclhp4\u0026q=85\u0026s=321632804eda4b3cff044941f9ccadda\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.zeeg.me#website\",\"name\":\"Zeeg Developer Hub\",\"url\":\"https://developer.zeeg.me\",\"publisher\":{\"@id\":\"https://developer.zeeg.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.zeeg.me/api/crm/update-a-crm-person#webpage\",\"url\":\"https://developer.zeeg.me/api/crm/update-a-crm-person\",\"name\":\"Assert a CRM Person\",\"description\":\"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\",\"dateModified\":\"2026-06-11T13:33:37.000Z\",\"isPartOf\":{\"@id\":\"https://developer.zeeg.me#website\"},\"breadcrumb\":{\"@id\":\"https://developer.zeeg.me/api/crm/update-a-crm-person#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.zeeg.me/api/crm/update-a-crm-person#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://developer.zeeg.me/api/scheduled-events/list-scheduled-events\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CRM\",\"item\":\"https://developer.zeeg.me/api/crm/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"People\",\"item\":\"https://developer.zeeg.me/api/crm/list-crm-people\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Assert a CRM Person\",\"item\":\"https://developer.zeeg.me/api/crm/update-a-crm-person\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.zeeg.me/api/crm/update-a-crm-person#apireference\",\"headline\":\"Assert a CRM Person\",\"name\":\"Assert a CRM Person\",\"description\":\"Create or update a CRM person via the Zeeg CRM API, matching on any standard or custom attribute slug to upsert contacts in bulk imports and sync jobs\",\"url\":\"https://developer.zeeg.me/api/crm/update-a-crm-person\",\"mainEntityOfPage\":{\"@id\":\"https://developer.zeeg.me/api/crm/update-a-crm-person#webpage\"},\"dateModified\":\"2026-06-11T13:33:37.000Z\",\"publisher\":{\"@id\":\"https://developer.zeeg.me/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.zeeg.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zeeg Developer Hub\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zeeg Developer Hub\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/crm/update-a-crm-person.md","siteName":"Zeeg Developer Hub","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/booking-flow"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"group":"Scheduled Events","expanded":false,"pages":[{"title":"List Scheduled Events","openapi":"GET /scheduled-events","href":"/api/scheduled-events/list-scheduled-events"},{"title":"Get a Scheduled Event","openapi":"GET /scheduled-events/{uuid}","href":"/api/scheduled-events/get-a-scheduled-event"},{"title":"Get Reschedule Availability","openapi":"GET /scheduled-events/{uuid}/reschedule-availability","href":"/api/scheduled-events/get-reschedule-availability"},{"title":"Reschedule a Scheduled Event","openapi":"PUT /scheduled-events/{uuid}/reschedule","href":"/api/scheduled-events/reschedule-a-scheduled-event"},{"title":"Cancel a Scheduled Event","openapi":"PUT /scheduled-events/{uuid}/cancel","href":"/api/scheduled-events/cancel-a-scheduled-event"},{"title":"Cancel a Scheduled Invitee","openapi":"PUT /scheduled-invitees/{uuid}/cancel","href":"/api/scheduled-events/cancel-a-scheduled-invitee"},{"title":"Handover a Scheduled Event","openapi":"PUT /scheduled-events/{uuid}/handover","href":"/api/scheduled-events/handover-a-scheduled-event"}]},{"group":"Scheduling Pages","expanded":false,"pages":[{"title":"List Scheduling Pages","openapi":"GET /event-types","href":"/api/scheduling-pages/list-scheduling-pages"},{"title":"Get a Scheduling Page","openapi":"GET /event-types/{uuid}","href":"/api/scheduling-pages/get-a-scheduling-page"},{"title":"Create a Scheduling Page","openapi":"POST /event-types","href":"/api/scheduling-pages/create-a-scheduling-page"},{"title":"Update a Scheduling Page","openapi":"PATCH /event-types/{uuid}","href":"/api/scheduling-pages/update-a-scheduling-page"},{"title":"Duplicate a Scheduling Page","openapi":"POST /event-types/{uuid}/duplicate","href":"/api/scheduling-pages/duplicate-a-scheduling-page"},{"title":"Delete a Scheduling Page","openapi":"DELETE /event-types/{uuid}","href":"/api/scheduling-pages/delete-a-scheduling-page"},{"title":"Get Scheduling Page Questions","openapi":"GET /event-types/{uuid}/questions","href":"/api/scheduling-pages/get-scheduling-page-questions"},{"title":"Replace Scheduling Page Questions","openapi":"PUT /event-types/{uuid}/questions","href":"/api/scheduling-pages/replace-scheduling-page-questions"},{"title":"Get Scheduling Page Notifications","openapi":"GET /event-types/{uuid}/notifications","href":"/api/scheduling-pages/get-scheduling-page-notifications"},{"title":"Update Scheduling Page Notifications","openapi":"PATCH /event-types/{uuid}/notifications","href":"/api/scheduling-pages/update-scheduling-page-notifications"},{"title":"Toggle Scheduling Page Status","openapi":"PUT /event-types/{uuid}/status","href":"/api/scheduling-pages/toggle-scheduling-page-status"},{"title":"List Event Page Dates","openapi":"GET /event-types/{uuid}/sessions","href":"/api/scheduling-pages/list-event-page-dates"},{"title":"Add Event Page Dates","openapi":"POST /event-types/{uuid}/sessions","href":"/api/scheduling-pages/add-event-page-dates"},{"title":"Change an Event Page Date","openapi":"PUT /event-types/{uuid}/sessions/{sessionUuid}","href":"/api/scheduling-pages/update-an-event-page-date"},{"title":"Remove an Event Page Date","openapi":"DELETE /event-types/{uuid}/sessions/{sessionUuid}","href":"/api/scheduling-pages/delete-an-event-page-date"},{"title":"Get a Single-Use Scheduling Link","openapi":"GET /event-types/{uuid}/single-use-link","href":"/api/scheduling-pages/get-a-single-use-scheduling-link"},{"title":"Get Available Time Slots","openapi":"GET /availability/{ownerSlug}/event-types/{eventTypeSlug}","href":"/api/scheduling-pages/get-available-time-slots"},{"title":"Get Available Time Slots by ID","openapi":"GET /event-types/{uuid}/availability","href":"/api/scheduling-pages/get-available-time-slots-by-id"},{"title":"Create an Event","openapi":"POST /event","href":"/api/scheduling-pages/create-an-event"}]},{"group":"Availability Schedule","expanded":false,"pages":[{"title":"Get All Availability Schedules","openapi":"GET /schedules","href":"/api/availability/get-all-availability-schedules"},{"title":"Get Default Availability Schedule","openapi":"GET /schedules/default","href":"/api/availability/get-default-availability-schedule"},{"title":"Update Default Availability Schedule","openapi":"PATCH /schedules/default","href":"/api/availability/update-default-availability-schedule"},{"title":"Get Availability Schedule by UUID","openapi":"GET /schedules/{uuid}","href":"/api/availability/get-availability-schedule-by-uuid"},{"title":"Update Availability Schedule by UUID","openapi":"PATCH /schedules/{uuid}","href":"/api/availability/update-availability-schedule-by-uuid"},{"title":"List Time-Off Periods","openapi":"GET /time-off","href":"/api/availability/list-time-off-periods"},{"title":"Create Time-Off Periods","openapi":"POST /time-off","href":"/api/availability/create-time-off-periods"},{"title":"Update Time-Off Period","openapi":"PATCH /time-off/{uuid}","href":"/api/availability/update-time-off-period"},{"title":"Delete Time-Off Period","openapi":"DELETE /time-off/{uuid}","href":"/api/availability/delete-time-off-period"},{"title":"List Holiday Categories","openapi":"GET /holidays/categories","href":"/api/holidays/list-holiday-categories"},{"title":"Preview Holidays for a Category","openapi":"GET /holidays/preview","href":"/api/holidays/preview-holidays"},{"title":"List Holiday Subscriptions","openapi":"GET /holidays/subscriptions","href":"/api/holidays/list-holiday-subscriptions"},{"title":"Create Holiday Subscriptions","openapi":"POST /holidays/subscriptions","href":"/api/holidays/create-holiday-subscriptions"},{"title":"Delete a Holiday Subscription","openapi":"DELETE /holidays/subscriptions/{id}","href":"/api/holidays/delete-holiday-subscription"},{"title":"Toggle Holiday Overrides","openapi":"PUT /holidays/subscriptions/{id}/overrides","href":"/api/holidays/toggle-holiday-overrides"}]},{"group":"Webhooks","expanded":false,"pages":[{"title":"Create Webhook Subscription","openapi":"POST /webhooks","href":"/api/webhooks/create-webhook-subscription"},{"title":"List Webhook Subscriptions","openapi":"GET /webhooks/scope/{scope}","href":"/api/webhooks/list-webhook-subscriptions"},{"title":"Get Webhook Subscription","openapi":"GET /webhooks/{uuid}","href":"/api/webhooks/get-webhook-subscription"},{"title":"Delete Webhook Subscription","openapi":"DELETE /webhooks/{uuid}","href":"/api/webhooks/delete-webhook-subscription"}]},{"group":"Notes","expanded":false,"pages":[{"title":"Create a Note","openapi":"POST /notes","href":"/api/notes/create-a-note"},{"title":"List Notes by Event","openapi":"GET /notes/event/{uuid}","href":"/api/notes/list-notes-by-event"},{"title":"Get a Note","openapi":"GET /notes/{id}","href":"/api/notes/get-a-note"},{"title":"Update a Note","openapi":"PUT /notes/{id}","href":"/api/notes/update-a-note"},{"title":"Delete a Note","openapi":"DELETE /notes/{id}","href":"/api/notes/delete-a-note"}]},{"group":"Workspaces \u0026 Teams","expanded":false,"pages":[{"title":"Check Logged-in User","openapi":"GET /whoami","href":"/api/workspaces-teams/check-logged-in-user"},{"title":"List Users in a Workspace","openapi":"GET /organizations/users","href":"/api/workspaces-teams/list-users-in-a-workspace"},{"title":"List Teams","openapi":"GET /teams","href":"/api/workspaces-teams/list-teams"},{"title":"Create a Team","openapi":"POST /teams","href":"/api/workspaces-teams/create-a-team"},{"title":"Update a Team","openapi":"PATCH /teams/{teamId}","href":"/api/workspaces-teams/update-a-team"},{"title":"Delete a Team","openapi":"DELETE /teams/{teamId}","href":"/api/workspaces-teams/delete-a-team"},{"title":"List Team Members","openapi":"GET /teams/{teamId}/members","href":"/api/workspaces-teams/list-team-members"},{"title":"Add a Team Member","openapi":"POST /teams/{teamId}/members","href":"/api/workspaces-teams/add-a-team-member"},{"title":"Remove a Team Member","openapi":"DELETE /teams/{teamId}/members/{memberId}","href":"/api/workspaces-teams/remove-a-team-member"},{"title":"Invite People to the Workspace","openapi":"POST /organizations/invitations","href":"/api/workspaces-teams/invite-people"},{"title":"List Pending Invitations","openapi":"GET /organizations/invitations","href":"/api/workspaces-teams/list-invitations"},{"title":"Revoke an Invitation","openapi":"DELETE /organizations/invitations/{invitationId}","href":"/api/workspaces-teams/revoke-an-invitation"}]},{"group":"AI Agent","expanded":false,"pages":[{"title":"Create Outbound Call","openapi":"POST /agents/{agentUuid}/outbound-calls","href":"/api/ai-agent/create-outbound-call"},{"title":"List AI Agents","openapi":"GET /agents","href":"/api/ai-agent/list-agents"},{"title":"List Agent Calls","openapi":"GET /agents/{agentUuid}/calls","href":"/api/ai-agent/list-agent-calls"},{"title":"Get Agent Call","openapi":"GET /agent-calls/{callId}","href":"/api/ai-agent/get-agent-call"}]},{"group":"Webhook Payloads","expanded":false,"pages":[{"title":"Event Webhook Payload","href":"/api/webhook-payloads/event-webhook-payload"},{"title":"Routing Form Webhook Payload","href":"/api/webhook-payloads/routing-form-webhook-payload"},{"title":"AI Agent Call Webhook Payload","href":"/api/webhook-payloads/ai-agent-call-webhook-payload"}]},{"group":"CRM","expanded":false,"pages":[{"title":"CRM Overview","href":"/api/crm/overview"},{"group":"Objects","pages":[{"title":"List CRM Objects","openapi":"GET /crm/objects","href":"/api/crm/list-crm-objects"},{"title":"Get a CRM Object","openapi":"GET /crm/objects/{slug}","href":"/api/crm/get-a-crm-object"},{"title":"Create a CRM Object","openapi":"POST /crm/objects","href":"/api/crm/create-a-crm-object"},{"title":"Update a CRM Object","openapi":"PATCH /crm/objects/{slug}","href":"/api/crm/update-a-crm-object"},{"title":"Delete a CRM Object","openapi":"DELETE /crm/objects/{slug}","href":"/api/crm/delete-a-crm-object"},{"title":"Add Attribute to CRM Object","openapi":"POST /crm/objects/{slug}/attributes","href":"/api/crm/add-attribute-to-crm-object"},{"title":"Update CRM Object Attribute","openapi":"PATCH /crm/objects/{slug}/attributes/{attributeKey}","href":"/api/crm/update-crm-object-attribute"}]},{"group":"Companies","pages":[{"title":"List CRM Companies","openapi":"GET /crm/companies","href":"/api/crm/list-crm-companies"},{"title":"Get a CRM Company","openapi":"GET /crm/companies/{id}","href":"/api/crm/get-a-crm-company"},{"title":"Create a CRM Company","openapi":"POST /crm/companies","href":"/api/crm/create-a-crm-company"},{"title":"Assert a CRM Company","openapi":"PUT /crm/companies","href":"/api/crm/assert-a-crm-company"},{"title":"Patch a CRM Company","openapi":"PATCH /crm/companies/{id}","href":"/api/crm/patch-a-crm-company"},{"title":"Delete a CRM Company","openapi":"DELETE /crm/companies/{id}","href":"/api/crm/delete-a-crm-company"}]},{"group":"People","pages":[{"title":"List CRM People","openapi":"GET /crm/people","href":"/api/crm/list-crm-people"},{"title":"Get a CRM Person","openapi":"GET /crm/people/{id}","href":"/api/crm/get-a-crm-person"},{"title":"Create a CRM Person","description":"Create a new person record in the Zeeg CRM API with first or last name, link them to an existing company by UUID, and attach social profile URLs","openapi":"POST /crm/people","href":"/api/crm/create-a-crm-person"},{"title":"Assert a CRM Person","openapi":"PUT /crm/people","href":"/api/crm/update-a-crm-person"},{"title":"Patch a CRM Person","description":"Update a CRM person via the Zeeg CRM API by sending only the contact fields to change, including single social links; the rest stays intact.","openapi":"PATCH /crm/people/{id}","href":"/api/crm/patch-a-crm-person"},{"title":"Delete a CRM Person","openapi":"DELETE /crm/people/{id}","href":"/api/crm/delete-a-crm-person"}]},{"group":"Records","pages":[{"title":"List CRM Records","openapi":"GET /crm/{objectSlug}","href":"/api/crm/list-crm-records"},{"title":"Get a CRM Record","openapi":"GET /crm/{objectSlug}/{recordId}","href":"/api/crm/get-a-crm-record"},{"title":"Create a CRM Record","openapi":"POST /crm/{objectSlug}","href":"/api/crm/create-a-crm-record"},{"title":"Assert a CRM Record (Upsert)","openapi":"PUT /crm/{objectSlug}","href":"/api/crm/assert-a-crm-record"},{"title":"Patch a CRM Record","openapi":"PATCH /crm/{objectSlug}/{recordId}","href":"/api/crm/patch-a-crm-record"},{"title":"Delete a CRM Record","openapi":"DELETE /crm/{objectSlug}/{recordId}","href":"/api/crm/delete-a-crm-record"},{"title":"Update a CRM Record Relation","openapi":"PATCH /crm/{objectSlug}/{recordId}/relation","href":"/api/crm/update-relation-crm-record"}]}]},{"group":"Routing Forms","expanded":false,"pages":[{"title":"Routing Forms Overview","href":"/api/routing-forms/overview"},{"group":"Forms","pages":[{"title":"List Routing Forms","openapi":"GET /routing-forms","href":"/api/routing-forms/list-routing-forms"},{"title":"Get a Routing Form","openapi":"GET /routing-forms/{id}","href":"/api/routing-forms/get-a-routing-form"},{"title":"Create a Routing Form","openapi":"POST /routing-forms","href":"/api/routing-forms/create-a-routing-form"},{"title":"Update a Routing Form","openapi":"PATCH /routing-forms/{id}","href":"/api/routing-forms/update-a-routing-form"},{"title":"Duplicate a Routing Form","openapi":"POST /routing-forms/{id}/duplicate","href":"/api/routing-forms/duplicate-a-routing-form"},{"title":"Replace Routing Form Questions","openapi":"PUT /routing-forms/{id}/inputs","href":"/api/routing-forms/replace-routing-form-questions"},{"title":"Replace Routing Form Routes","openapi":"PUT /routing-forms/{id}/routes","href":"/api/routing-forms/replace-routing-form-routes"},{"title":"Delete a Routing Form","openapi":"DELETE /routing-forms/{id}","href":"/api/routing-forms/delete-a-routing-form"}]},{"group":"Submissions","pages":[{"title":"List Routing Form Submissions","openapi":"GET /routing-form-submissions","href":"/api/routing-forms/list-routing-form-submissions"},{"title":"Get a Routing Form Submission","openapi":"GET /routing-form-submissions/{id}","href":"/api/routing-forms/get-a-routing-form-submission"},{"title":"Delete a Routing Form Submission","openapi":"DELETE /routing-form-submissions/{id}","href":"/api/routing-forms/delete-a-routing-form-submission"}]}]}]}]}]},"basePath":"","title":"Assert a CRM Person - Zeeg Developer Hub","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"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","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.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"]}