Two-Factor Authentication

Two-factor authentication (2FA) protects your Repull dashboard, and with it your API keys and webhooks. With 2FA on, signing in needs your password and a one-time code, so a leaked password alone can't get into your account.

Turn it on

Go to Dashboard → Settings → Security and set up one or both methods:

  • Authenticator app (recommended): scan the QR code with Google Authenticator, 1Password, Authy or any TOTP app, then enter the 6-digit code it shows.
  • SMS: codes are texted to the verified phone number on your account.

With both set up, choose which one is primary: sign-in asks for it first, and the other is available under Try another way. Switch the primary method or remove one any time in Settings → Security.

When 2FA turns on you get 10 recovery codes. Each one signs you in once if you lose your phone. They are shown only once, so download, copy or print them and keep them somewhere safe. Generate new recovery codes in Settings → Security gives you a fresh set; your current codes stop working.

Signing in

After your password, enter the 6-digit code from your primary method. With SMS as primary, the text is sent as soon as the code screen opens; you can resend it after 30 seconds. Try another way lets you use your other method or a recovery code. After 5 wrong codes, sign-in is paused for 15 minutes.

Email is not a second factor: with 2FA on, a code sent to your email never signs you in. If someone gets into your mailbox, they still can't get past 2FA.

Confirming sensitive actions

Some changes ask you to confirm it's you with a fresh code, even if you're already signed in: creating, rotating or revoking an API key; adding, changing or deleting a webhook, or rotating its signing secret; changing the billing email; and turning card access on or off. One code covers the next 10 minutes. Accounts without 2FA confirm with an emailed code.

We also email you when an API key is created or rotated, a webhook is added or its URL changes, 2FA is turned on or off, and when your account is signed in to from a new browser.

When 2FA is required

  • Card access. To receive card details (for example virtual cards) from channels, every member of the workspace needs 2FA. Card access is turned on in Settings → Security, and while it is on, 2FA can't be turned off.
  • Larger workspaces. Workspaces with 100 or more properties, or more than one member, are asked to turn on 2FA and get 14 days before it becomes required. The date is shown in the dashboard and sent by email.

API requests made with an API key are not affected: 2FA protects the dashboard where keys are created and managed.

Lost your phone?

Sign in with your other method or a recovery code, then set up 2FA again in Settings → Security. If you have neither, email hello@repull.devfrom your account email. We verify your identity before resetting 2FA, and you'll get an email when it's done.

AI