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

Amazon Setup Guide

This is the complete guide to setting up and running Amazon releases and restocks in Refract. Follow each section in order if you are a new user. For Freebies & Deals, use its own guide instead:

Amazon Freebies & Deals 101

Prerequisites

  • Amazon accounts with a default shipping address and default payment method already set on the account. Amazon is the only site where this is required; there are no profiles on Amazon, so Refract checks out with what is on the account.

  • Amazon Teen and Amazon Business accounts are supported.

  • ISP proxies, at least 1 per task.

  • The product's ASIN and Offer ID. Run both; ASIN by itself is often too slow.

  • Optional: 2FA secrets for accounts with 2FA enabled (see Amazon 2FA Secret Creation).

Accounts Setup

1

Add your accounts

In the Accounts tab, create your accounts with Amazon US as the site (see the Accounts guide for the add flow). If an account has 2FA, paste its key into the 2FA Secret field:

Amazon 2FA Secret Creation
2

Check the account's defaults

Make sure each account has a default shipping address and default payment method set on Amazon itself. Refract uses the account's data at checkout, not a profile.

3

Log the accounts in

Amazon accounts must be logged in before you create tasks. Select the accounts and click the lock button. Amazon is the only site that logs in this way; do this first, every time.

Task Group Setup

Create a task group with Amazon US as the site (see Task Group Creation), then configure the settings panel:

The Amazon US task group settings panel
The Amazon group panel. Run ASIN + Offer ID together.
Setting
Value
Notes

Use Multi Input

OFF unless running multiple products

Formats below

Monitor Input

The product's ASIN

From the URL: amazon.com/dp/B08SGTGTZDB08SGTGTZD. A URL will not work

Monitor Proxy List

Your ISP list

Can be the same list as your tasks

Monitor Delay

3500 (default)

Offer ID

The product's OID

Run ASIN + OID together. ASIN alone is often too slow

Allow Third Party Vendors

OFF

ON to include third-party offers. Does nothing with an OID (already seller-specific)

Allow Used Products

OFF

ON to include used offers. Does nothing with an OID (already condition-specific)

Price Min / Price Max

Leave blank

Price filters for 1 item, before tax and shipping. Blank means no limit. Whole dollars only: round up, no cents

Notify when Offer ID Found

Optional

Posts to your notifications webhook when the monitor finds an Offer ID

Skip Monitoring (If Offer ID is present)

OFF

Max. Checkout Errors

5 (default)

Checkout errors allowed before the task stops the attempt and returns to monitoring

Loop Checkouts

OFF

ON to keep attempting checkouts after each success

Multi Input formats (one per line, only with Use Multi Input on):

All inputs are monitored at once, not one at a time.

The lower half of the Amazon group settings
The lower half of the panel: vendor and condition toggles, prices, OID options, and Max Checkout Errors.

Task Creation

Click + in the task group to open Create Tasks.

The Amazon Create Tasks window
Normal mode for releases and restocks. Raffle mode enters raffles, typically Amazon Japan.
Setting
Value
Notes

Mode

Normal

Raffle enters raffles instead, typically for Amazon Japan

Use Account Proxy

OFF

Only if you deliberately assigned account proxies

Task Proxy List

Your ISP list

At least 1 ISP per task

Accounts

Your accounts or Account Group

Force Free Shipping (Slower)

OFF

ON prioritizes free shipping on accounts without Prime, at the cost of speed

Retry Delay

3500 (default)

Task Qty

1 to 5

Tasks created per account. Up to 5 per account works if you have the proxies for it

Item Quantity

1

A ceiling, not an exact number: the task goes for the max it can get, up to what you set. Safe to set high. See How Item Quantity works

Offer ID, explained

An Offer ID is a unique identifier for a specific product offer from a specific seller. Running an OID targets and spams Add to Cart on that exact listing, bypassing traditional monitoring for speed. For extremely limited items that go out of stock instantly, an OID can be the only way to cart in time.

The rules:

  • ASIN is required alongside the OID. An OID never runs alone.

  • OIDs are not price-specific. Prices can and do change on the same OID, so set a Price Max.

  • OIDs change frequently, and that is fine. The same user can get a different OID on every refresh, multiple OIDs often point to the same offer, and old OIDs keep working. As long as it points to the right offer, it does not matter which one you have.

  • OIDs come from your cook group or monitors, and the in-bot monitor feed.

Skip Monitoring (If Offer ID is present): with an OID in place, this skips monitoring entirely and immediately spams cart attempts. Use it when you know the drop time or the item is actively restocking and you need instant carts. Otherwise leave it off.

Common statuses

Access Denied

What it means: the account or proxy was flagged. This is normal on Amazon. The strategy is to keep running through it and let tasks retry.

On the monitor specifically: a few Access Denied responses when first starting are normal. The monitor rotates proxies and settings in the background until it finds the optimal setup, then sits on "monitoring" for long stretches. That means it is working. The only concern is nonstop Access Denied spam that never recovers, which points to flagged proxies or accounts.

If it truly never recovers: increase task delays, let the account rest for several hours or days, or use fresh, higher-quality proxies.

Soft Banned (OOS)

What it means: Amazon is returning a false Out of Stock even though the product is available. It is a soft ban on the specific account, proxy, or session, usually from too many requests too fast, low-trust proxies, or rapid logins from multiple locations.

How to handle it: same strategy, keep running. If it persists: switch proxies, try a different account, let the account rest, or increase the retry delay.

No Default Payment Method / No Default Address

Amazon sometimes drops default settings on its own. To fix:

  1. Address: verify the default shipping address on the account (the address section in the top left of the Amazon homepage) and make sure it is marked default.

  2. Payment: remove the current default payment method and re-add it to re-establish it as the default.

FAQ

How many accounts do I need?

As many as you can have. There is no set number.

How many tasks per account?

Up to 5 tasks per account works, assuming you have the proxies for it (at least 1 ISP per task). Set Task Qty accordingly; it creates that many tasks per account.

What delays should I run?

Monitor 3500, task retry 3500. The defaults.

What proxies should I use on Amazon?

ISP proxies, at least 1 per task.

On Amazon, match your proxy location to where you are running. If your server is in Virginia, run proxies geolocated in Virginia. That is all there is to it, and it is an Amazon rule specifically, not general advice for every site.

Do Amazon Japan items ship to the US?

Almost none of them do. If your Japan orders keep getting blocked or cancelled, that is usually the reason rather than anything in your setup. Check that the item actually ships to your country before running it.

Do I need an ASIN if I am running an OID?

Yes. ASIN and OID always run together on Amazon.

Are Teen and Business accounts supported?

Yes, both.

Can I run another task on an account that is already doing Freebies?

Yes. Running an additional task for a different item on the same account is fine.

Is Price Max before or after tax and shipping?

Before. Price Max is the total of just the item.

Use a whole dollar amount: cents are not supported, so round up to the next dollar (40, not 39.99). A price max with cents in it stops the task picking the product up at all.

Will the bot adjust quantity if Amazon's max is lower than my Item Quantity?

Yes. Item Quantity is a ceiling, not an exact number: if you request 4 and Amazon allows 2, the bot automatically goes for 2. You can set it high and let the task take the most it can get. This is automatic on every site except Walmart, which needs its Allow Lower Item Quantity toggle. See How Item Quantity works.

Last updated

Was this helpful?