> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Manually link (merge) a SaaS account to another account

> You can link unknown accounts or guest accounts that have no retrievable email address to another employee account or system account.

## Overview

Manually merge SaaS accounts (guest or employee) to another employee account, system account, or guest account.

## Use cases

You can use this feature for the following purposes:

* SaaS services that cannot retrieve email addresses (e.g., GitHub) produce unknown IDs. Link those accounts to manage offboarding.
* Link a guest account with an email domain different from the employee master to the same person's primary account. This applies when the guest account uses a secondary address.
  Example: The employee master uses Google Workspace. Microsoft 365 operates under the "onmicrosoft.com" domain. Link the onmicrosoft.com account to the Google Workspace domain email address for offboarding management.

## **Managing unknown accounts**

1. Connect a SaaS service.
2. Detect unknown accounts.
3. Use merge to link them to an employee account or another account.

<h2 id="linking-merge-method">
  **How to link (merge)**
</h2>

The Directory screen offers two ways to link (merge) accounts.

**Bulk change**: Click **\[Merge]** in the upper right.

**Individual change**: Click the three-dot menu **\[︙]** on the source account, then click **\[Merge]**.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-12-47-34.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=33202d11770449d59d62dbd806d5c4ab" alt="Screenshot" width="1900" height="426" data-path="images/it-management/d97dy5z2l7/2025-09-28-12-47-34.png" />

## **Running a merge**

1. Click **\[Merge]** to open the "Merge IDs" screen. This screen shows the list of mergeable accounts (or the individually selected account).

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-13-26-11.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=0d618290d018750f3b190c17722f46e1" alt="Screenshot" width="1216" height="882" data-path="images/it-management/d97dy5z2l7/2025-09-28-13-26-11.png" />

2. Click an ID in the "Matching existing ID" column to display the target account for linking.

The target account list shows up to 50 accounts. Search by name or email address to find the right account.
If the user has multiple email addresses, find the **Primary** one under Directory > User Info > Email Address. Specify that account as the merge target.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-13-26-36.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=bdc65135356f53c6959454011d3d76fe" alt="Screenshot" width="1310" height="898" data-path="images/it-management/d97dy5z2l7/2025-09-28-13-26-36.png" />

3. Select the target account and click **\[Apply]**.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-13-27-02.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=c5e52697da1caeaa588b5d68b5843302" alt="Screenshot" width="1218" height="884" data-path="images/it-management/d97dy5z2l7/2025-09-28-13-27-02.png" />

4. A confirmation message appears when the merge succeeds.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-13-42-32.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=041fd844d617decc34c8ebb6f5668ed7" alt="Screenshot" width="698" height="86" data-path="images/it-management/d97dy5z2l7/2025-09-28-13-42-32.png" />

## **Checking merge results**

Check the target account in the Directory. After a successful merge, the merged account count appears as "N account(s)".

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-12-51.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=5f626b2f7fefd17c10354284d070dbaf" alt="Screenshot" width="2544" height="334" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-12-51.png" />

Click **\[Total IDs]** to view the linked accounts.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-13-03.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=e95ef420d8c395371a010f1d089cd863" alt="Screenshot" width="2280" height="490" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-13-03.png" />

<h2 id="account-separation-unmerge">
  **Separating accounts (unmerge)**
</h2>

Remove a link (merge) and restore the account to its pre-merge state.

1. Go to Directory > select the account to unlink > select the **\[Total IDs]** tab. Click **\[Separate]** from the three-dot menu **\[︙]**.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-17-06.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=7052d8a2dd41ef5130afc4bddd92d6c8" alt="Screenshot" width="2284" height="526" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-17-06.png" />

2. A confirmation screen appears. Click **\[Separate]**.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-17-25.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=d205f17c81d5394b5b26ac03c7f53891" alt="Screenshot" width="742" height="298" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-17-25.png" />

3. "Merge cancelled" appears when the separation succeeds.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-18-26.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=0c165a4d1069b1b89fcd02941e841723" alt="Screenshot" width="700" height="92" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-18-26.png" />

4. The separated account appears in the Directory list.

<img src="https://mintcdn.com/admina-sbn/PEEndzio9f5-afJr/images/it-management/d97dy5z2l7/2025-09-28-14-28-02.png?fit=max&auto=format&n=PEEndzio9f5-afJr&q=85&s=138f791a39ec417ac01ae2b248a15edd" alt="Screenshot" width="2540" height="414" data-path="images/it-management/d97dy5z2l7/2025-09-28-14-28-02.png" />

## **Merging and unmerging via API**

You can also merge and unmerge using the following API endpoints.

Merge: [Merge people in batch](/en/api-reference/it-management/introduction#tag/Organization/operation/mergePeople)

[How to use the Merge identity with addressless entities Tool](/en/it-management/saas-management/6ax6mziqu2-merge-identity-with-addressless-entities#usage)

Unmerge: [Unmerges people](/en/api-reference/it-management/introduction#tag/Organization/operation/unmergePeople)

## **Notes**

Merged accounts no longer appear in the Directory list. Check the source account before merging.
When you remove a merge, the account reappears in the Directory list.
Perform merges and unmerges while the connected SaaS is syncing normally.

## **Merge targets**

The following table shows the ID types that can be used as merge source and merge target for manual linking.
See [Supplement 2: Type](/en/it-management/directory/nqxa0so8wh-admina-directory#type) for details on ID types.

| ID type **(source / target)** | Internal ID | External ID | System ID | Unknown | Unmanaged ID |
| ----------------------------- | ----------- | ----------- | --------- | ------- | ------------ |
| Internal ID                   | ◯           | -           | -         | -       | -            |
| External ID                   | ◯           | ◯           | -         | -       | -            |
| System ID                     | ◯           | ◯           | ◯         | -       | -            |
| Unknown                       | ◯           | ◯           | ◯         | -       | ◯            |
| Unmanaged ID                  | ◯           | ◯           | ◯         | -       | -            |

## **FAQ**

## Q. I cannot find the unmerge screen.

A. Go to Directory > select the account to unlink > click **\[Total IDs]** to remove the merge. See the [Separating accounts (unmerge)](#account-separation-unmerge) section for details.

## Q. After merging, I try to change the primary/secondary email address. I see "A user with this email address already exists" and cannot proceed.

A. If that message appears after merging, perform an [**Account separation (unmerge)**](#account-separation-unmerge).
Then specify the account to register as **Primary** under Directory > User Info > Email Address as the merge target. After that, [run the merge](#linking-merge-method) again.
