Skip to content

Test accounts

Test accounts can be used to build automated tests, for local development, or to reduce friction during Apple's App Store review process for mobile apps. A new set of credentials are created each time you enable the test account, and the old one is revoked to keep your account secure.

INFO

To use these test accounts, your app must support email or SMS login. Testing other login flows can either be automated with a library like Playwright, or by completing the flow manually, as it requires authorization with other APIs (such as social providers).

To enable a test account for your app and get its login credentials, go to the Settings page of the Privy Dashboard and turn on the Enable test accounts toggle. Once enabled, you will see the login credentials for your test account that you can use for your app ID.

All test credentials follow the same format, where XXXX/XXXXXX in the credentials below should be substituted with the values you see in the Settings page of the Dashboard. You cannot substitute arbitrary values for XXXX/XXXXXX or use plus addressing; you must use the credentials from the Dashboard exactly.

emailphoneOTP (for either)
test-XXXX@privy.io+1 555 555 XXXXXXXXXX

Once enabled, a test user can log into your app with the provided email or phone number and the provided OTP code to review and test your app.

TIP

Test accounts have a lighter authentication rate limit for apps in development. While all accounts in production apps and non-test accounts in development apps are limited to 5 requests every 5 minutes for email and 5 requests every 10 minutes for SMS, test accounts in development apps are limited to 10 requests every 10 seconds for either.

INFO

Depending on when you created your Privy app, you may have a legacy test account enabled with the login credentials test@privy.io or +1 555 555 5555. Please see the Settings page of the Privy Dashboard to determine if this is the case for your app.