Changing the phone number on a session

Link the new account

You can change a session’s phone number through the dashboard or API, but the new WhatsApp account must be linked with a fresh QR scan. Editing the phone number field alone does not switch the account behind an active connection.

1. Pause any workflows that send through this session.
2. Disconnect the current session and update its phone number in session settings.
3. Start the connection process to obtain a new QR code.
4. On the new account’s phone, open WhatsApp’s Linked Devices screen and scan the QR code.
5. Confirm that the session is connected and test sending and receiving before resuming your workflows.

Check the connected identity

Make sure the phone scanning the QR code is signed in to the account you intend to use. Review your webhook routing and application records if they associate this session with the previous phone number.

If linking fails, see QR code linking troubleshooting.