---
title: "Merge a user"
method: POST
path: "/admin/users/{id}/merge.json"
tags: ["Users", "Admin"]
---

# Merge a user

`POST /admin/users/{id}/merge.json`

## Request

- Base URL: `https://discourse.example.com`
- URL: `https://discourse.example.com/admin/users/{id}/merge.json`
- Auth: none declared. Required headers: `Api-Key`, `Api-Username`

Merge a user into another user. Requires admin permissions. The
source user cannot be a staff member. The merge runs in the background and
deletes the source user when complete.

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required
- `Api-Username` string, required

## Request body

- object
  - `target_username` string, required: Username of the user to merge into

## Response `200`

response

- object
  - `success` string, required

## Changes

- **2026-10-01** `bd0cc899503b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/discourse/apis/discourse-api-documentation/changes/admin/users/:id/merge.json/post.md)

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) - [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/discourse/apis/discourse-api-documentation/revisions/8de25dc67c85?raw)