Skip to main content

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.
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 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. 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.