{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.\n\n{% admonition type=\"warning\" name=\"Merged contacts are not retrievable via the API\" %}\n  Once a merge is completed, the source contact (`from`) is permanently removed from the active contact list. This means:\n  - **GET /contacts/{id}** — Requesting the source contact by its original ID returns `410 Gone` with a `Link` header pointing to the contact it was merged into. See [Get a contact](/docs/references/rest-api/api.intercom.io/contacts/showcontact).\n  - **POST /contacts/search** — The source contact will not appear in search results, including queries filtered by `updated_at`.\n  - **GET /contacts** — The source contact will not appear in list results.\n\n  Only the target contact (`into`) remains accessible. If your application stores contact IDs, update them to use the target contact's ID after a merge.\n{% /admonition %}\n\nRequires the `read_write_users` or `write_users_companies` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"query":{"type":"object","properties":{"include_merge_history":{"type":"boolean","default":false,"description":"Pass `true` to include the merge history of the resulting contact in the response, with at most the 10 most recent merges."}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/merge_contacts_request","examples":[{"from":"6762f0d51bb69f9f2193bb7f","into":"6762f0d51bb69f9f2193bb80"}]}},"required":[],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"merge_contacts_request":{"description":"Merge contact data.","type":"object","title":"Merge contact data","required":["from","into"],"properties":{"from":{"type":"string","description":"The unique identifier for the contact to merge away from. Must be a lead.","examples":["5d70dd30de4efd54f42fd526"]},"into":{"type":"string","description":"The unique identifier for the contact to merge into. Must be a user.","examples":["5ba682d23d7cf92bef87bfd4"]},"skip_duplicate_validation":{"type":"boolean","description":"Set to `true` to merge two contacts that are not duplicates (they share no matching email or phone).","examples":[true]}}}}},"name":"Merge a lead and a user","id":"intercom.mergecontact","example":{},"maxRequests":1,"summary":false}}