Link a contact to an account
POST /api/contacts/{id}/link-account
POST
/api/contacts/{id}/link-account
Manually associates a contact with an account. This is used when the automatic account resolution (based on email domain) did not match the correct account, or when a contact needs to be reassigned. The contact’s resolution status is updated to ‘manually_resolved’.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
string format: uuid
The unique identifier of the contact to link.
Request Body
Section titled “Request Body ”object
accountId
required
The unique identifier of the account to link this contact to.
string
Example
ac1a2b3c-5678-9abc-def0-1234567890abResponses
Section titled “ Responses ”The contact has been linked to the account.
Simple success acknowledgment returned by action endpoints (reply, resolve, take-over, etc.).
object
ok
required
Always true on success.
boolean
Example
trueValidation error. The accountId may be invalid or the account may not exist in the tenant.
Standard error response returned by all endpoints on failure.
object
error
required
A human-readable error message describing what went wrong.
string
Example
Conversation not found