Skip to main content
PATCH
Upsert contact on relationship map

Authorizations

Authorization
string
header
required

Partner OAuth2 flows for integration API access tokens. Claude MCP custom connectors use authorization code with PKCE S256.

Scopes

relationship_maps:write

Create and update relationship maps.

Headers

X-Organization-Id
string<uuid>

Active organization UUID. Required for authenticated requests when the principal has access to multiple organizations.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Path Parameters

buyerMapId
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
contactId
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Query Parameters

organizationId
string<uuid>

Read-only convenience alias for X-Organization-Id. Legacy subscriberId query param is also accepted.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Body

application/json
supportStatus
string | null

Supporter, Neutral, or Detractor (case-insensitive). Use decisionStatus for Champion or Coach. Null or an empty string clears the status; invalid values return details.validValues.

decisionStatus
string | null

Buyer authority from the organization UI vocabulary, including Champion, Coach, Influencer, Decision Maker, Economic Buyer, Functional/Business Evaluator, and Technical Evaluator by default. Case-insensitive; custom organization values are supported. Null or an empty string clears it; invalid values return details.validValues.

contactStatus
string | null

Contacted, Not Contacted, Actively Engaged, or Ghosting (case-insensitive). Null or an empty string clears the status; invalid values return details.validValues.

functionalRole
string
executiveId
string
buyingGroupId
string<uuid>
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Response

Updated map contact.

buyerMap
object
required