Email address of the salesperson or user who owns this contact.
Example:
"37673840-6259-40f9-bbe5-a7db40f8e3cf"
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bridge REST Integrations API \u0026 Webhooks","description":"Documentation for Bridge Integrations API Webhooks","colors":{"primary":"#2563EB","light":"#3B82F6","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_light.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=9a9d74ac33a89d538635507ba8d12eb9","dark":"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_dark.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=0c0905478472ab3f3b07066824f7f4ca"},"favicon":"https://mintcdn.com/sainapsisinc/OxyPsTqCEnnNpE4v/favicon.png?fit=max\u0026auto=format\u0026n=OxyPsTqCEnnNpE4v\u0026q=85\u0026s=8262683efaf26e188f464e1f0f02a189","navbar":{"links":[{"href":"mailto:support@sainapsis.com","label":"Contact Support"}],"primary":{"type":"button","label":"Bridge app","href":"https://app.bridge.new"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/sainapsis-inc"}},"markdown":{"instructions":["Bridge exposes three integration surfaces: the REST Integrations API for pushing data into Bridge, webhooks for receiving events from Bridge, and the public Lead Capture endpoint that a tenant's landing page posts to.","The Integrations API host is https://api-connect-us.bridge.new and every request to it must be authenticated with the x-api-key header. Bridge does not use bearer tokens or OAuth.","The Lead Capture endpoint is different and the Integrations API rules do not apply to it: it has its own host, it takes no x-api-key and no authentication header of any kind, and it is called from a visitor's browser. It is identified by a workspace id and a capture key together with a reCAPTCHA token. Never tell a reader to authenticate it with an API key, and never tell them to keep its capture key out of frontend code - it is designed to live in the page.","Integrations API error codes follow the BRIDGE_\u003cDOMAIN>_\u003cNNNN> format, for example BRIDGE_CONVERSATION_0001, and are listed on the error codes page. Lead Capture error codes follow a different format, BRIDGE.CAMPAIGN_LEADS.\u003cNAME>, and are listed on the Lead Capture error reference. Never invent a code that is not listed on the page for its own surface.","This documentation covers the Integrations API, webhooks and Lead Capture only. It does not describe the Bridge web application or its internal APIs."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sainapsisinc","hasAudioNarration":false,"actualSubdomain":"sainapsisinc","customDomains":["docs.bridge.new"],"gitSource":{"type":"github","owner":"sainapsis","repo":"open-api-public-documentation-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ac4fa21407ba61c44c6207e","collectionId":"132bc2f9-70e6-4658-a660-b3eb5e90fda1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ac4fa21407ba61c44c6207e"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ac4fa21407ba61c44c6207e","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"REST API","count":21},{"language":"default","tag":"Introduction","count":6},{"language":"default","tag":"Lead Capture","count":6},{"language":"default","tag":"Contacts API","count":5},{"language":"default","tag":"Conversations API","count":5},{"language":"default","tag":"Webhooks","count":4},{"language":"default","tag":"Integration","count":3},{"language":"default","tag":"Before you launch","count":2},{"language":"default","tag":"Internal Users API","count":2},{"language":"default","tag":"LeadScout API","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-logo{height:2.5rem}"}],"page":{"pagePath":"api-reference/contacts-api/create-or-update-a-contact","slug":"/api-reference/contacts-api/create-or-update-a-contact","pageMetadata":{"title":"Create or update a contact","description":"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts/partial","href":"/api-reference/contacts-api/create-or-update-a-contact","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\"\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 or update a contact","description":"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts/partial","href":"/api-reference/contacts-api/create-or-update-a-contact","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Contacts API"],"summary":"Create or update a contact","description":"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.","operationId":"create_partial_contact_bridge_api_v1_workspaces__workspaceId__contacts_partial_post","security":["06a9efab-787a-4732-bac8-0549ad92ef25"],"parameters":["72d5fb92-69d6-4a4a-a3f6-ed2a8a6b2bdd"],"requestBody":"6946487a-abca-42f7-98f5-f1a9851aa05f","responses":{"201":"48424240-53c6-429d-9c63-415c271773a0","403":"9081e58e-460f-4928-88de-d1d16204806c","404":"a2b40002-a66b-4e8b-9591-ddc94e3f6b54","409":"ee808ef3-003b-41f0-b632-5c8c4418e88d","422":"bbe04ce7-df9c-49e4-9a04-7e5eebac8fb7","429":"639bc83b-e92d-4ff2-9f2f-e2901349e99d"},"method":"post","type":"path","servers":["1770656e-ef46-492b-9652-7813582e686a"],"path":"/bridge/api/v1/workspaces/{workspaceId}/contacts/partial","baseUrlOptions":["https://api-connect-us.bridge.new"],"title":"Create or update a contact","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"72d5fb92-69d6-4a4a-a3f6-ed2a8a6b2bdd":{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Unique identifier of the workspace (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"title":"Workspaceid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Unique identifier of the workspace (UUID v4)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cellphone":{"type":"string","format":"phone","title":"Cellphone","description":"Contact's cellphone number in E.164 format. Used to identify the contact for upsert.","examples":["+14084029292"],"isRequired":true,"uniqueKey":"cellphone","typeLabel":"string\u003cphone>"},"firstName":{"oneOf":[{"type":"string","title":"First Name","description":"Contact's first name. Required for NORMAL classification.","example":"Maria","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","title":"First Name","description":"Contact's first name. Required for NORMAL classification.","example":"Maria","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","title":"Last Name","description":"Contact's last name. Required for NORMAL classification.","example":"Lopez","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Name","description":"Contact's last name. Required for NORMAL classification.","example":"Lopez","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","description":"Contact's email address.","format":"email","example":"maria@acme.com","uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","title":"Email","description":"Contact's email address.","example":"maria@acme.com","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"languageCode":{"oneOf":[{"type":"string","title":"LanguageCode","description":"Contact's language code. Required for NORMAL classification.","enum":["ES","EN"],"example":"EN","uniqueKey":"languageCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Language Code","description":"Contact's language code. Required for NORMAL classification.","example":"EN","uniqueKey":"languageCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"languageCode","typeLabel":"enum\u003cstring> | null"},"ownerIdentifier":{"oneOf":[{"type":"object","title":"InternalUserIdentifierRequest","description":"Body to identify an internal user in Bridge System.","required":["identifier","identifierType"],"example":{"identifier":"jane@acme.com","identifierType":"EMAIL"},"properties":{"identifier":{"type":"string","title":"Identifier","description":"User identifier value.","examples":["john.doe@example.com","+13802098869","37673840-6259-40f9-bbe5-a7db40f8e3cf"],"isRequired":true,"uniqueKey":"ownerIdentifier.oneOf.0.identifier","typeLabel":"string"},"identifierType":{"type":"string","enum":["ID","EMAIL"],"title":"Identifier Type","description":"Type of identifier for internal users (ID or EMAIL).","examples":["EMAIL","ID"],"isRequired":true,"uniqueKey":"ownerIdentifier.oneOf.0.identifierType","typeLabel":"enum\u003cstring>"}},"uniqueKey":"ownerIdentifier.oneOf.0","typeLabel":"InternalUserIdentifierRequest · object"},{"type":"null","title":"Owner Identifier","description":"Identifier of the salesperson or user who owns this contact.","example":{"identifier":"jane@acme.com","identifierType":"EMAIL"},"uniqueKey":"ownerIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"ownerIdentifier","typeLabel":"InternalUserIdentifierRequest · object | null"},"customAttributes":{"properties":{"openAttributes":{"oneOf":[{"type":"array","items":{"properties":{"customAttributeId":{"type":"string","title":"Custom Attribute Identifier","description":"Unique open custom attribute identifier.","examples":["651c97c1-b31d-466f-825c-fe77b39e7ae6"],"isRequired":true,"uniqueKey":"customAttributes.openAttributes.oneOf.0.items.[INDEX].customAttributeId","typeLabel":"string"},"content":{"type":"string","title":"Content","description":"Value of open attribute.","isRequired":true,"uniqueKey":"customAttributes.openAttributes.oneOf.0.items.[INDEX].content","typeLabel":"string"}},"type":"object","required":["customAttributeId","content"],"title":"OpenAttributeRequest","description":"Request body for open custom attributes operations.","uniqueKey":"customAttributes.openAttributes.oneOf.0.items.[INDEX]","typeLabel":"OpenAttributeRequest · object"},"title":"Open Attributes","description":"Array of open attributes.","uniqueKey":"customAttributes.openAttributes.oneOf.0","typeLabel":"OpenAttributeRequest · object[]"},{"type":"null","title":"Open Attributes","description":"Array of open attributes.","uniqueKey":"customAttributes.openAttributes.oneOf.1","typeLabel":"null"}],"uniqueKey":"customAttributes.openAttributes","typeLabel":"OpenAttributeRequest · object[] | null"},"closedAttributes":{"oneOf":[{"type":"array","items":{"properties":{"customAttributeId":{"type":"string","title":"Custom Attribute Identifier","description":"Unique closed custom attribute identifier.","examples":["651c97c1-b31d-466f-825c-fe77b39e7ae6"],"isRequired":true,"uniqueKey":"customAttributes.closedAttributes.oneOf.0.items.[INDEX].customAttributeId","typeLabel":"string"},"closedCustomAttributeIds":{"items":{"type":"string","uniqueKey":"customAttributes.closedAttributes.oneOf.0.items.[INDEX].closedCustomAttributeIds.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Closed Custom Attribute Identifiers","description":"List of unique closed attribute value identifiers.","examples":[["62de01f0-fd48-467c-9c35-18647c51532a","6faf42bb-7d7b-44bd-9e79-5de6fd491134"]],"isRequired":true,"uniqueKey":"customAttributes.closedAttributes.oneOf.0.items.[INDEX].closedCustomAttributeIds","typeLabel":"string[]"}},"type":"object","required":["customAttributeId","closedCustomAttributeIds"],"title":"ClosedAttributeRequest","description":"Request body for closed custom attributes operations.","uniqueKey":"customAttributes.closedAttributes.oneOf.0.items.[INDEX]","typeLabel":"ClosedAttributeRequest · object"},"title":"Closed Attributes","description":"Array of closed attributes.","uniqueKey":"customAttributes.closedAttributes.oneOf.0","typeLabel":"ClosedAttributeRequest · object[]"},{"type":"null","title":"Closed Attributes","description":"Array of closed attributes.","uniqueKey":"customAttributes.closedAttributes.oneOf.1","typeLabel":"null"}],"uniqueKey":"customAttributes.closedAttributes","typeLabel":"ClosedAttributeRequest · object[] | null"}},"type":"object","title":"Custom Attributes","description":"Object with open and closed custom attributes.","examples":[{"closedAttributes":[],"openAttributes":[]}],"uniqueKey":"customAttributes","typeLabel":"Custom Attributes · object"}},"additionalProperties":false,"type":"object","required":["cellphone"],"title":"CreatePartialContactBody","description":"Request body for partial contact creation. Only cellphone is required.","uniqueKey":"","typeLabel":"CreatePartialContactBody · object"},"examples":{"Example":{"title":"Example","value":{"cellphone":"+14084029292","firstName":"Maria","lastName":"Lopez","email":"maria@acme.com","languageCode":"EN","ownerIdentifier":{"identifier":"jane@acme.com","identifierType":"EMAIL"},"customAttributes":{"closedAttributes":[],"openAttributes":[]}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"48424240-53c6-429d-9c63-415c271773a0":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Identifier","description":"Unique identifier for the contact (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"workspaceId":{"type":"string","title":"Workspace Identifier","description":"Unique identifier of the workspace this contact belongs to","examples":["92b2d4f3-81e1-4b61-a7ec-6f4ff3b58be5"],"isRequired":true,"uniqueKey":"workspaceId","typeLabel":"string"},"type":{"type":"string","enum":["PARTIAL","NORMAL"],"title":"Contact Type","description":"NORMAL when all required identity and custom attribute fields are present, PARTIAL otherwise.","examples":["NORMAL","PARTIAL"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","title":"Created At","description":"Timestamp when the contact was created.","examples":["2003-04-10T08:00:00.000Z"],"isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"type":"string","title":"Updated At","description":"Timestamp when the contact was last updated.","examples":["2003-04-10T08:00:00.000Z"],"isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","title":"First Name","description":"Contact's first name.","example":"John","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","title":"First Name","description":"Contact's first name.","example":"John","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","title":"Last Name","description":"Contact's last name.","example":"Doe","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Name","description":"Contact's last name.","example":"Doe","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","description":"Contact's email address.","format":"email","example":"john.doe@example.com","uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","title":"Email","description":"Contact's email address.","example":"john.doe@example.com","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"cellphone":{"oneOf":[{"type":"string","title":"Cellphone","description":"Contact's cellphone address.","format":"phone","example":"+14084029292","uniqueKey":"cellphone.oneOf.0","typeLabel":"string\u003cphone>"},{"type":"null","title":"Cellphone","description":"Contact's cellphone address.","example":"+14084029292","uniqueKey":"cellphone.oneOf.1","typeLabel":"null"}],"uniqueKey":"cellphone","typeLabel":"string\u003cphone> | null"},"customAttributes":{"items":{"properties":{"key":{"type":"string","title":"Key","description":"Attribute key/name","isRequired":true,"uniqueKey":"customAttributes.items.[INDEX].key","typeLabel":"string"},"values":{"items":{"type":"string","uniqueKey":"customAttributes.items.[INDEX].values.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Values","description":"Attribute value","uniqueKey":"customAttributes.items.[INDEX].values","typeLabel":"string[]"}},"type":"object","required":["key"],"title":"CustomAttributeResponse","description":"Response body for custom attributes in contact-related operations.","uniqueKey":"customAttributes.items.[INDEX]","typeLabel":"CustomAttributeResponse · object"},"type":"array","title":"Custom Attributes","description":"Array of custom key-value attributes.","uniqueKey":"customAttributes","typeLabel":"CustomAttributeResponse · object[]"},"languageCode":{"oneOf":[{"type":"string","title":"LanguageCode","description":"Language code from external user.","enum":["ES","EN"],"example":"EN","uniqueKey":"languageCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Language Code","description":"Language code from external user.","example":"EN","uniqueKey":"languageCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"languageCode","typeLabel":"enum\u003cstring> | null"},"ownerId":{"oneOf":[{"type":"string","title":"Owner Identifier","description":"Email address of the salesperson or user who owns this contact.","example":"37673840-6259-40f9-bbe5-a7db40f8e3cf","uniqueKey":"ownerId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Owner Identifier","description":"Email address of the salesperson or user who owns this contact.","example":"37673840-6259-40f9-bbe5-a7db40f8e3cf","uniqueKey":"ownerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"ownerId","typeLabel":"string | null"}},"type":"object","required":["id","workspaceId","type","createdAt","updatedAt"],"title":"ContactResponse","description":"Response body for contact-related operations.","uniqueKey":"","typeLabel":"ContactResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234","workspaceId":"92b2d4f3-81e1-4b61-a7ec-6f4ff3b58be5","type":"NORMAL","createdAt":"2003-04-10T08:00:00.000Z","updatedAt":"2003-04-10T08:00:00.000Z","firstName":"John","lastName":"Doe","email":"john.doe@example.com","cellphone":"+14084029292","customAttributes":[{"key":"\u003cstring>","values":["\u003cstring>"]}],"languageCode":"EN","ownerId":"37673840-6259-40f9-bbe5-a7db40f8e3cf"}}},"exampleType":"generated"}},"exampleType":"generated"},"9081e58e-460f-4928-88de-d1d16204806c":{"description":"Forbidden","content":{"application/json":{"examples":{"FORBIDDEN":{"title":"FORBIDDEN","value":{"title":"Forbidden","status":403,"code":"BRIDGE_CORE_0301"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Short, summary of the problem type.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"HTTP status code generated by the origin server for this occurrence of the problem.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Extra information about the problem.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Extra information about the problem.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Object representing a Problem response body.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"a2b40002-a66b-4e8b-9591-ddc94e3f6b54":{"description":"Not Found","content":{"application/json":{"examples":{"WORKSPACE_NOT_FOUND":{"title":"WORKSPACE_NOT_FOUND","value":{"title":"Workspace Not Found","status":404,"code":"BRIDGE_WORKSPACE_0001"}},"INTERNAL_USER_NOT_FOUND":{"title":"INTERNAL_USER_NOT_FOUND","value":{"title":"Internal User Not Found","status":404,"code":"BRIDGE_INTERNAL_0001"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Short, summary of the problem type.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"HTTP status code generated by the origin server for this occurrence of the problem.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Extra information about the problem.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Extra information about the problem.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Object representing a Problem response body.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"ee808ef3-003b-41f0-b632-5c8c4418e88d":{"description":"Conflict","content":{"application/json":{"examples":{"EMAIL_OWNED_BY_ANOTHER_CONTACT":{"title":"EMAIL_OWNED_BY_ANOTHER_CONTACT","value":{"title":"Email Owned By Another Contact","status":409,"code":"BRIDGE_EXTERNAL_0013"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Short, summary of the problem type.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"HTTP status code generated by the origin server for this occurrence of the problem.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Extra information about the problem.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Extra information about the problem.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Object representing a Problem response body.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"bbe04ce7-df9c-49e4-9a04-7e5eebac8fb7":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"639bc83b-e92d-4ff2-9f2f-e2901349e99d":{"description":"Too Many Requests","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Short, summary of the problem type.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"HTTP status code generated by the origin server for this occurrence of the problem.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explanation specific to this occurrence of the problem.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"Trace ID for debugging purposes.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Error code for identification, view the error codes page for more details.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"List of error details.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Extra information about the problem.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Extra information about the problem.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Object representing a Problem response body.","uniqueKey":"","typeLabel":"Problem · object"},"examples":{"WORKSPACE_BUDGET_EXHAUSTED":{"title":"WORKSPACE_BUDGET_EXHAUSTED","value":{"title":"Too Many Requests","status":429,"code":"BRIDGE_RATE_LIMIT_0001"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"06a9efab-787a-4732-bac8-0549ad92ef25":{"x-api-key":{"type":"apiKey","description":"Copy the API key as provided by the Bridge Console.","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"}}},"servers":{"1770656e-ef46-492b-9652-7813582e686a":{"url":"https://api-connect-us.bridge.new","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Copy the API key as provided by the Bridge Console.","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","description":"Copy the API key as provided by the Bridge Console.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"sainapsisinc","siteName":"Bridge REST Integrations API \u0026 Webhooks","title":"Create or update a contact - Bridge REST Integrations API \u0026 Webhooks","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T13:40:02.258Z","originalFileLocation":"api-reference/contacts-api/create-or-update-a-contact.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create or update a contact - Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sainapsisinc.mintlify.app/_mintlify/api/og/v2?division=Contacts+API\u0026amp;title=Create+or+update+a+contact\u0026amp;description=Create+or+update+a+contact+using+only+cellphone.+Classifies+as+NORMAL+or+PARTIAL.\u0026amp;theme=fbb9ff84c04418b3fc52c1b9\u0026amp;signature=6227c4a455530c791062021f09d07570be8a3f67ea9d529451cfb5bd7e3411bf\">\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 or update a contact - Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sainapsisinc.mintlify.app/_mintlify/api/og/v2?division=Contacts+API\u0026amp;title=Create+or+update+a+contact\u0026amp;description=Create+or+update+a+contact+using+only+cellphone.+Classifies+as+NORMAL+or+PARTIAL.\u0026amp;theme=fbb9ff84c04418b3fc52c1b9\u0026amp;signature=6227c4a455530c791062021f09d07570be8a3f67ea9d529451cfb5bd7e3411bf\">\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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/contacts-api/create-or-update-a-contact.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bridge.new/#organization\",\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"url\":\"https://docs.bridge.new\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_light.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=9a9d74ac33a89d538635507ba8d12eb9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bridge.new#website\",\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"url\":\"https://docs.bridge.new\",\"publisher\":{\"@id\":\"https://docs.bridge.new/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact#webpage\",\"url\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact\",\"name\":\"Create or update a contact\",\"description\":\"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\",\"dateModified\":\"2026-10-06T13:40:02.258Z\",\"isPartOf\":{\"@id\":\"https://docs.bridge.new#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Contacts API\",\"item\":\"https://docs.bridge.new/api-reference/contacts-api/retrieve-a-contact-by-id\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create or update a contact\",\"item\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact#apireference\",\"headline\":\"Create or update a contact\",\"name\":\"Create or update a contact\",\"description\":\"Create or update a contact using only cellphone. Classifies as NORMAL or PARTIAL.\",\"url\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bridge.new/api-reference/contacts-api/create-or-update-a-contact#webpage\"},\"dateModified\":\"2026-10-06T13:40:02.258Z\",\"publisher\":{\"@id\":\"https://docs.bridge.new/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bridge.new#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Bridge REST Integrations API \u0026 Webhooks","nav":{"global":null,"tabs":[{"tab":"Introduction","pages":[{"title":"Introduction","href":""}]},{"tab":"REST API","groups":[{"group":"Health","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/health","href":"/api-reference/health/health-check"}]},{"group":"Conversations API","pages":[{"title":"Get conversation by id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}","href":"/api-reference/conversations-api/get-conversation-by-id"},{"title":"Update conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}","href":"/api-reference/conversations-api/update-conversation"},{"title":"Retrieve conversations with flexible filtering options","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/conversations","href":"/api-reference/conversations-api/retrieve-conversations-with-flexible-filtering-options"},{"title":"Creates a new conversation with flexible user identification.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/conversations","href":"/api-reference/conversations-api/creates-a-new-conversation-with-flexible-user-identification"},{"title":"Release conversation","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}/release","href":"/api-reference/conversations-api/release-conversation"}]},{"group":"Messages API","pages":[{"title":"Create a new message","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/messages","href":"/api-reference/messages-api/create-a-new-message"}]},{"group":"Contacts API","pages":[{"title":"Retrieve a contact by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/contacts/{contactId}","href":"/api-reference/contacts-api/retrieve-a-contact-by-id"},{"title":"Update contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml patch /bridge/api/v1/workspaces/{workspaceId}/contacts/{contactId}","href":"/api-reference/contacts-api/update-contact"},{"title":"List contacts with filtering and pagination","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/contacts","href":"/api-reference/contacts-api/list-contacts-with-filtering-and-pagination"},{"title":"Create a new contact","description":"Create a new contact in the specified workspace.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts","href":"/api-reference/contacts-api/create-a-new-contact"},{"title":"Create or update a contact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts/partial","href":"/api-reference/contacts-api/create-or-update-a-contact"}]},{"group":"Files API","pages":[{"title":"Create presigned uploads for files","description":"Generates presigned URLs to upload files (Presigned PUT). Validates extension, contentType, and type-specific limits. Checksum required: send SHA-256 digest in checksumBase64 (Base64). Upload must include header x-amz-checksum-sha256 with the same value.\n\n---\nTo upload your files, you MUST use the returned presigned URL with the HTTP PUT method. Ensure that you upload the file exactly to the URL indicated, without modifications (as required by AWS S3 Presigned URL PUT usage). Refer to the official AWS S3 documentation on Presigned PUT URLs for details: [AWS S3 Presigned PUT Documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html).\nBe sure to include all required headers as specified in the response (e.g., 'x-amz-checksum-sha256' with the correct SHA-256 value). If you fail to use the correct HTTP method or headers, AWS will reject the upload request.\n\n\u003ctable>\u003ctr>\u003cth>Type\u003c/th>\u003cth>Extension\u003c/th>\u003cth>Content Type\u003c/th>\u003cth>Max Size\u003c/th>\u003c/tr>\u003ctr>\u003ctd rowspan=\"4\">Image\u003c/td>\u003ctd>.jpeg\u003c/td>\u003ctd>image/jpeg\u003c/td>\u003ctd rowspan=\"4\">16 MB\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.jpg\u003c/td>\u003ctd>image/jpeg\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.png\u003c/td>\u003ctd>image/png\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.webp\u003c/td>\u003ctd>image/webp\u003c/td>\u003c/tr>\u003ctr>\u003ctd rowspan=\"2\">GIF\u003c/td>\u003ctd>.gif\u003c/td>\u003ctd>image/gif\u003c/td>\u003ctd rowspan=\"2\">3 MB\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.mp4\u003c/td>\u003ctd>video/mp4\u003c/td>\u003c/tr>\u003ctr>\u003ctd rowspan=\"3\">Video\u003c/td>\u003ctd>.avi\u003c/td>\u003ctd>video/x-msvideo\u003c/td>\u003ctd rowspan=\"3\">64 MB\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.mov\u003c/td>\u003ctd>video/quicktime\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.mp4\u003c/td>\u003ctd>video/mp4\u003c/td>\u003c/tr>\u003ctr>\u003ctd rowspan=\"4\">Audio\u003c/td>\u003ctd>.m4a\u003c/td>\u003ctd>audio/mp4\u003c/td>\u003ctd rowspan=\"4\">16 MB\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.mp3\u003c/td>\u003ctd>audio/mpeg\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.ogg\u003c/td>\u003ctd>audio/ogg\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.wav\u003c/td>\u003ctd>audio/wav\u003c/td>\u003c/tr>\u003ctr>\u003ctd rowspan=\"8\">Document\u003c/td>\u003ctd>.doc\u003c/td>\u003ctd>application/msword\u003c/td>\u003ctd rowspan=\"8\">100 MB\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.docx\u003c/td>\u003ctd>application/vnd.openxmlformats-officedocument.wordprocessingml.document\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.pdf\u003c/td>\u003ctd>application/pdf\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.ppt\u003c/td>\u003ctd>application/vnd.ms-powerpoint\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.pptx\u003c/td>\u003ctd>application/vnd.openxmlformats-officedocument.presentationml.presentation\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.txt\u003c/td>\u003ctd>text/plain\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.xls\u003c/td>\u003ctd>application/vnd.ms-excel\u003c/td>\u003c/tr>\u003ctr>\u003ctd>.xlsx\u003c/td>\u003ctd>application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\u003c/td>\u003c/tr>\u003c/table>","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/files","href":"/api-reference/files-api/create-presigned-uploads-for-files"}]},{"group":"Custom attributes API","pages":[{"title":"Retrieve custom attributes by workspaceId","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/settings/attributes","href":"/api-reference/custom-attributes-api/retrieve-custom-attributes-by-workspaceid"}]},{"group":"Provider channels API","pages":[{"title":"Get provider channels by workspace id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/provider-channels","href":"/api-reference/provider-channels-api/get-provider-channels-by-workspace-id"},{"title":"Get provider channels by workspace id and provider type","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/provider-channels/{messageProviderType}","href":"/api-reference/provider-channels-api/get-provider-channels-by-workspace-id-and-provider-type"}]},{"group":"LeadScout API","pages":[{"title":"Initiate a LeadScout outbound conversation with a known lead","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/outbound","href":"/api-reference/leadscout-api/initiate-a-leadscout-outbound-conversation-with-a-known-lead"},{"title":"Request a manual handoff of a LeadScout conversation to internal users","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/conversations/{conversationId}/handoff","href":"/api-reference/leadscout-api/request-a-manual-handoff-of-a-leadscout-conversation-to-internal-users"}]},{"group":"Templates API","pages":[{"title":"Discover a template's agnostic variable inventory","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/templates/{templateId}","href":"/api-reference/templates-api/discover-a-templates-agnostic-variable-inventory"}]},{"group":"Internal Users API","pages":[{"title":"Retrieve an internal user by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/users/{userId}","href":"/api-reference/internal-users-api/retrieve-an-internal-user-by-id"},{"title":"List internal users with filtering and pagination","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/users","href":"/api-reference/internal-users-api/list-internal-users-with-filtering-and-pagination"}]}]},{"tab":"Lead Capture","pages":[{"title":"Lead Capture","href":"/lead-capture"}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks"}]}]},"basePath":"","title":"Create or update a contact - Bridge REST Integrations API \u0026 Webhooks","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}