---
title: "Merge people"
description: "Marks this account and another person as the same individual, in your workspace only. The person in `into` receives the mentions, tags, notes and outreach activities, and keeps its owner and stage, taking the other's where it has none."
canonical: https://docs.rumoro.dev/api/people/merge-people
markdown: https://docs.rumoro.dev/api/people/merge-people.mdx
---

# Merge people

`POST /v1/people/{id}/merge`

Marks this account and another person as the same individual, in your workspace only. The person in `into` receives the mentions, tags, notes and outreach activities, and keeps its owner and stage, taking the other's where it has none.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The person's id (aut_...). |

## Body

| Field | Required | Description |
| --- | --- | --- |
| `into` | yes | The id of the person to merge this account into. |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The person who now has this account |
| 401 | The API key is missing or not valid |
| 404 | Your workspace does not know one of the two |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).