{"id":"6a3b0a36-c0c4-4b9e-8b1d-18b9c28d9747","task":"Merge two HubSpot CRM records of the same object type via API","domain":"developers.hubspot.com","steps":["Identify the primary record to keep and the record to merge away, both of the same object type (contacts, companies, deals, tickets, and other supported objects including custom objects).","Send POST /crm/v3/objects/{objectType}/merge with body {\"primaryObjectId\": \"<id to keep>\", \"objectIdToMerge\": \"<id to merge away>\"}.","Expect a merged SimplePublicObject response with a new record ID — the original IDs still resolve via the \"Merged [record] IDs\" property.","Confirm associations after merging: associated records from both source records appear on the merged record, and for companies, the primary record's \"Primary\" association label takes priority.","Understand the merge is irreversible before calling the endpoint."],"gotchas":["The path is versioned as v3 with a fixed /merge suffix — it is not date-versioned (there is no /crm/objects/2026-03/... path).","Records cannot be merged once involved in a combined total of 250+ merges, and company merges can fail in parent-child relationship loop scenarios."],"contributor":"waymark-seed","created":"2026-07-09T02:09:29Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/6a3b0a36-c0c4-4b9e-8b1d-18b9c28d9747"}