Skip to content

Amazon Listings

Add-on: Amazon Listings (available on Pro and Canopy plans)

The Amazon Listings add-on lets you create and manage Amazon product listings directly from Iraca and push them to Amazon via the Selling Partner API (SP-API). Listings are saved as drafts in Iraca first — you control when they are submitted to Amazon.


Before you start

You need an active Amazon integration. Go to Integrations → Channels and connect your Amazon Seller account using your SP-API credentials (client ID, client secret, refresh token, seller ID) before creating any listings.


Creating a listing

Amazon listings require more information than other channels because Amazon uses a product-type schema to enforce which attributes each product category needs.

  1. Go to Integrations → Amazon Listings.
  2. Click New Listing.
  3. Step 1 — Product: select the Amazon connection, search for the Iraca product you want to list, and enter a Seller SKU (defaults to the product's internal SKU).
  4. Step 2 — Product Type: search for an Amazon product type (e.g. "HOT_SAUCE", "GROCERY"). Amazon uses this to determine which attributes are required. Type at least 2 characters to search.
  5. Step 3 — Attributes: fill in the title, brand, description, bullet points, keywords, and images. Below these fields, a Required Attributes section appears showing any additional attributes Amazon mandates for this product type. Required fields are marked with a red asterisk.
  6. Step 4 — Pricing: enter your price and an optional list price (MSRP shown as a crossed-out reference price).
  7. Step 5 — Review: verify all details and click Save Draft.

Weight & dimension pre-fill

When you reach Step 3 (Attributes) and the product type schema loads, Iraca automatically pre-fills any weight or dimension attribute fields from the product's stored values. Attributes that may be pre-filled include:

  • item_weight / item_package_weight — from the product's weight (kg)
  • item_length, item_width, item_height — from the product's dimensions (cm)

These are starting values for your review — you can change them before saving. If a product type doesn't require those attributes they won't appear.

At push time, Iraca also injects properly-formatted weight and dimension values into the SP-API payload for any of the above keys that are absent from the listing's stored attributes. Amazon expects these in a structured format ({value, unit} objects) which Iraca handles automatically.


Submitting a listing to Amazon

From the listings table, click Submit to Amazon on any row.

  • Amazon processes the submission asynchronously. The listing status changes to Submitted.
  • Iraca polls Amazon for the result. Once processed, the status changes to Active, Inactive, or Error.
  • If Amazon returns issues (validation errors), they appear in the listing row. Fix the flagged attributes, re-save, and resubmit.

Images

Add up to 8 images per listing. The first image is sent as the main product image (main_product_image_locator); additional images are sent as alternate images.

Product library: when you select a product, images already stored on that product appear as quick-add suggestions. Click a thumbnail to add it without re-uploading.

Upload: click Upload image to upload directly from your device. The file is stored in your Iraca account and the URL is used in the Amazon submission.

Amazon requires the main product image to have a pure white background and no watermarks or additional text. Other marketplace rules (image size, resolution) are enforced by Amazon at submission time — Iraca passes the URL as-is.


Fulfillment channel

All listings created through Iraca are Fulfilled by Merchant (FBM). Amazon FBA support (where Amazon stores and ships your inventory) is planned for a future release.


Listing statuses

StatusWhat it means
DraftSaved in Iraca, not yet submitted to Amazon
SubmittedSent to Amazon; awaiting processing
ActiveLive on Amazon (BUYABLE)
InactiveAmazon has the listing but it is not buyable
ErrorAmazon returned validation errors; see listing detail

Editing a listing

Click the pencil icon to reopen the drawer. After making changes, click Save Draft, then Submit to Amazon to push the updated listing.


Deleting a listing

Deleting a listing in Iraca removes the record from Iraca only. It does not remove the listing from Amazon — you must do that through Seller Central or the SP-API separately.

This guide covers the Iraca app and its add-ons. The Iraca Marketplace is documented separately.