> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Change a number's customer

> Reassign a connected WhatsApp number to another customer in the same project without reconnecting it

## Change the customer

Project **owners and admins** can move an eligible production number from its current customer to another customer in the same project. You do not need a Kapso operator for an eligible transfer. Regular members need a project owner or admin to make the change.

1. Open **Phone numbers** and the number's settings.
2. In **General → Customer**, open the **⋮** menu and choose **Change customer**.
3. Select the destination customer. Only other available customers in this project appear.
4. Review the source, destination, history counts, contact changes and access warnings.
5. Check the confirmation that the number belongs to the destination customer and that you have reviewed the access change, then click **Change customer**.

If the destination does not exist yet, create it in **Customers** first. A customer being deleted cannot receive a number.

> [!WARNING]
>
> The destination customer gains access to the number and its entire history. The source customer loses customer-scoped inbox access. Review existing inbox links, webhook destinations, agents and workflows before confirming.

## What stays the same

The number stays connected to Meta. This changes its customer association without disconnecting or recreating the connection.

* The project, configuration, phone number and WABA stay the same.
* Credentials, templates, webhooks, agents and workflow attachments stay attached.
* Conversations, messages and calls retain their IDs and history.
* Number-scoped inbox links remain valid.
* Historical usage and billing attribution stay unchanged.

## Contacts and setup links

* Contacts referenced only by this number move to the destination with their IDs, notes and dependent records.
* Contacts shared with another number keep their current attribution and history references. They are not duplicated or deleted.
* Contacts with no activity linked to a number, or linked only to other numbers, stay with the source customer.
* Active setup and reconnection links for this number are revoked. This keeps the number connected. Create future reconnection links from the destination customer.
* Used, expired and already revoked setup links remain as history.

Customer-scoped inbox access follows the conversation's number. Sharing a contact does not grant access to another number's conversations.

## If the change is blocked

The dialog shows why the number cannot change customer. No partial transfer is applied.

| Blocker | Next step |
| - | - |
| Sandbox or WhatsApp Business App coexistence number | This flow is unavailable for these numbers. Do not disconnect the number to bypass the restriction. |
| History or contact synchronization is incomplete or failed | Wait for an active sync to finish. Contact support if it has failed or remains blocked. |
| Inbound messages, calls, broadcasts, workflows or agent executions are active | Let the work finish, or finish/stop it where supported, then reopen the dialog. |
| Number setup or reconnection is in progress | Finish that process before retrying. |
| The number or either customer is being deleted | Resolve the deletion state before attempting a transfer. |
| Contact or history ownership is inconsistent | Contact support with the blocker shown in the dialog. |
| The number is busy or the source customer changed | Refresh, review the current source and destination, and try again. |

This flow cannot move a number to another project or WABA, or change its connection mode. Do not use disconnect/reconnect for a same-project customer change that must preserve the existing connection and history.

Use the app for this operation. The public phone-number update API does not expose customer reassignment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.