Organization API

Update one Customer Relationship

Updates relationship contact mirrors by relationship id. firstName, lastName, and phone change the shared Customer only when this organization alone holds that Customer and it has no portal account. Otherwise they are saved on this relationship, read back as displayName and phone, and the shared Customer and every other organization stay as they were. ownerTeamMemberId is create-only here and is rejected on PATCH because Organization API v1 does not expose the staff reassignment action. Required scope: customers:write.

/api/v1/customer-relationships/{id}

Update one Customer Relationship. Use an organization API key with customers:write. Check the response envelope and meta.requestId before triggering dependent workflow steps.

Required scopes

customers:write

Parameters

Name	In	Type	Description
idrequired	path	string	Customer Relationship identifier returned by the Organization API.

Request body

objectrequired

Field	Type	Description
customerSalesforceAccountId	string \| null	Optional unless marked required.
billingEmail	string \| null	Invoice recipient for this organization. Blank or null uses the contact email.
email	string \| null	Optional unless marked required.
firstName	string \| null	Optional unless marked required.
lastName	string \| null	Optional unless marked required.
phone	string \| null	Optional unless marked required.

updatecustomerrelationshipRequest

{
  "phone": "+15555550124"
}

Responses

200

Updated Customer Relationship envelope

#/components/schemas/OrgApiResourceEnvelope

400

Validation error