I am unable to scan the QR Code in the Client Portal. How can I add a User to IB Key? (iPhone)

  • The IBKR Mobile app must be installed and IB Key Authentication already activated on this iOS device.
  • For more information on the installation and activation on iOS devices, please refer to KB2278.



1) On your iOS device, open the IBKR Mobile app.

     1.a) If the app opens with the login screen (Figure 1), tap on Services on the top-left corner (red arrow) and proceed with step 2)

     1.b) If the app opens with your Home Page, Portfolio, Watchlists, or similar, tap on More on the bottom-right corner (Figure 2). Then tap on Two-Factor Authentication (Figure 3), followed by Add User (Figure 4) and proceed with step 3)

Figure 1                                                 Figure 2                                              Figure 3                        


Figure 4                                                        


2) Tap on Authenticate (Figure 5) and then on Add User (Figure 6).

Figure 5                                                  Figure 6


3) Tap Setup IB Key using QR code (Figure 7).

Figure 7                      


4) Type the alphanumeric string present below the QR code in the Activation Code field (Figure 8).

Figure 8

8) Tap Activate IB Key (Figure 9).

Figure 9

9) You will receive a message indicating the successful activation of IB Key. Tap DONE to confirm (Figure 10).

Figure 10





Possible issues and solutions


  • During the IB Key activation, I receive an error message "An error has occurred. Please try again."

Figure 11

This error message (Figure 11) may indicate you are attempting to activate the IB Key for a user which was already enrolled. Please try to log that user in to the Client Portal again. If you receive a notification on your smartphone once you have entered the credentials and you are able to complete the authentication once you tap on that notification, then the user was already enrolled and you no longer need to follow the steps on this article.

Alternatively, the error message may be displayed when the QR code shown in the Client Portal was already used to attempt an activation and is expired. In this case, please log out of the Client Portal and log back in to obtain a fresh QR code.


  • See KB2260 for instruction on how to activate and operate IBKR Mobile Authentication.
  • See KB2748 for instructions on how to recover IBKR Mobile Authentication.
  • See KB3236 for instructions on how to enable notifications for the IBKR Mobile app.
  • See KB3234 for troubleshooting missing IBKR Mobile notifications.
  • See KB3073 for instructions on how to migrate the IB Key / IBKR Mobile authentication to a new smartphone.