HomeDocsCustom Credentials
Custom Credentials

Custom Credentials

Use your own test account email and password instead of auto-generated ones. Perfect for existing accounts, SSO flows, or pre-seeded staging environments.

How it works

By default, LazyHippo generates a temporary email and strong password for each run. If you prefer to use an existing test account, toggle "Use your own credentials" in the test config.

Useful for: testing existing accounts, SSO flows, staging environments with pre-seeded data, or apps that require manual email verification.

Parameters

ParameterTypeDescription
credentialMode'auto' | 'custom'Toggle between auto-generated and user-provided credentials
customCredentials.emailstringYour test account email address
customCredentials.passwordstringYour test account password (never stored in plain text)
Config with custom credentials
json
{
  "url": "https://yourapp.com",
  "test_type": "auth",
  "customCredentials": {
    "email": "test@yourcompany.com",
    "password": "your-test-password"
  }
}

When to use custom credentials

Existing accounts

Test login flows with a pre-created account that has specific data, permissions, or subscription tiers.

SSO / OAuth

If your app only supports SSO login (no email/password signup), provide the SSO test account credentials.

Seeded staging

Staging environments with pre-populated data that you want to test against, rather than creating new users.

Manual email verify

Apps that require manual email verification -- use an account you have already confirmed.

Warning
When using custom credentials with email confirmation enabled, LazyHippo cannot intercept emails sent to your address. You will need to confirm the email manually, or disable email confirmation.

Ready to let the hippo handle your QA?