For the complete documentation index, see llms.txt. This page is also available as Markdown.

Accounts

The Accounts tab in the left sidebar holds every site account the bot uses. It opens on your account groups, with All accounts as the default group.

The Accounts tab showing account groups
The Accounts tab opens on your groups. All accounts is the default.

The toolbar

Inside a group, the toolbar buttons from left to right:

  • + adds accounts.

  • The pencil edits the selected account.

  • The delete button deletes the selected accounts.

  • The lock logs into the selected accounts. This is for Amazon only; every other site logs in through tasks.

  • The last button clears sessions on the selected accounts, forcing a fresh login the next time tasks start.

  • The dropdown on the right filters the list by site.

The accounts toolbar buttons
Left to right: add, edit, delete, login (Amazon only), clear sessions, site filter.

Find accounts in the list

Use the account search to narrow the list down. It takes more than one account at a time: paste a whole list of logins into the search and the list filters to just those accounts.

That is the practical way to check a specific batch, like working out which of your accounts are SMS verified on Walmart. Paste the batch in, and you are looking at only those accounts instead of scrolling your whole list.

Add accounts

1

Open Create Account

Click the + button. The window has two input modes: Default and Mass Input.

2

Default: one account at a time

Choose the Site, then enter the Login (email) and Password.

The Create Account window on the Default tab
3

Mass Input: many at once

Switch to Mass Input, choose the Site, and paste one account per line in this format:

You can optionally append a proxy and a 2FA secret with semicolons: login:password;proxy;secret. Most users only need login:password.

The Create Account window on the Mass Input tab
One account per line. Only login:password is required.
4

Leave the proxy options alone

Skip the Proxy List / Input Proxy options and click Create Account.

For completeness, here is what an account proxy actually does if you do set one: the bot uses that proxy to log into the account. And on sites that have the Use Account Proxy toggle in task creation, enabling it makes the task use the account's proxy for every step, not just login. Neither is recommended for normal setups.

Account groups

Groups make it easy to select many accounts at once during task creation.

1

Create the group

On the Accounts tab, click the folder + (Create Group) button in the top right.

2

Name it and pick a color

Give the group a name and pick a color so it is easy to spot.

The Create Account Group window
Name it, pick a color, tick the accounts.
3

Add the accounts

Tick the accounts you want in the group, then click Create Group. You can also add accounts later: select them in All accounts with Ctrl+Click or Shift+Click, right-click, and add to group.

Import and export accounts

The two file buttons import and export accounts.

  • Import only accepts files exported by Refract. We do not support CSV imports from AYCD or any other tool.

  • Export writes accounts in Refract's proprietary format. The Include Sessions (Encrypted) toggle controls what you get: with sessions on, the export is an encrypted file that carries your accounts and their existing sessions, which is how you move accounts to another instance without re-logging in. With sessions off, accounts are written to a plaintext .txt file in login:password;proxy format. So if you just want a readable copy of your emails and passwords, export with Include Sessions (Encrypted) off.

The Export Accounts window with the Include Sessions toggle
Include Sessions on: encrypted file with sessions. Off: plaintext .txt.

Moving your whole setup to a new device? Use App Data export/import in Settings instead. It carries everything, not just accounts. See Settings.

Logging in

  • Amazon: accounts must be logged in before tasks can run. Select the accounts, then click the lock button.

  • Every other site: accounts log in through tasks. Start your tasks and the bot handles login. This is why the login button shows "Login via Tasks" for sites like Walmart.

The Status column showing Awaiting task login
Run tasks to log these in.

Clear a session

To clear an account's saved session, right-click the account and click Clear Session. To do many at once, select them and use the clear sessions button on the toolbar. Either way, the account goes through a fresh login the next time tasks start. Re-logging like this can refresh flagged session data, so it comes up in troubleshooting, for example with Walmart 456s.

FAQ

Does Refract use account or profile data at checkout?

If there is no profile input (Amazon only), Refract uses the account's data. If there is a profile input (most sites), Refract uses the profile info only. If a matching address is already on the account, it skips re-adding it to avoid stacking the same address over and over.

Can my account affect site anti-bots like Shape on Target?

No. Your account does not affect anti-bot systems like Shape.

What does "account does not exist" mean?

There is no valid account in Refract for the site you are running. Make sure you created an account entry matching the exact site and credentials.

Why do my passwords get reset on sites like Best Buy?

Password resets are a normal occurrence on sites like Best Buy. With Reset Invalid Password enabled on your tasks, the bot resets and stores the new password automatically.

Do I need to set a proxy or proxy list on my accounts?

No. Do not assign proxies directly to accounts for any site. Tasks handle proxies through the task proxy list.

Last updated

Was this helpful?