Link a marketplace buyer to a contact by order number
POST/api/contacts/:contactId/marketplace-links
An agent links the buyer behind an order number (read from the local
order mirror) to this contact (doc 70 §11 flow 5). 404 when the
order is not mirrored or the marketplace is not connected. 409 when
the buyer is already bound to another contact — nothing is changed and
a suggestion is opened (suggestion_id) so the agent can link or
merge. A contact may hold several accounts of one marketplace, so an
existing link to a different buyer is not a conflict. Needs the
contact update ability.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
Linked (or already linked to this contact).
Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).
Authenticated but not allowed.
Resource not found (or not visible to the current tenant).
Bound elsewhere; a suggestion was opened instead.
The request failed validation.
Rate limit exceeded.
Response Headers
Request quota for the current window.
Remaining requests in the current window.
Seconds to wait before retrying.