Skip to content

GunBroker

List products and sync orders with GunBroker marketplace

Updated View as Markdown

GunBroker Integration

Connect your FirearmCart store with GunBroker to list products on the marketplace and import orders back to your store.


Features

Feature Description
Product listings List products as fixed price or auction
Import existing listings Link listings you already had on GunBroker to your catalog by SKU or UPC
Order import Import GunBroker orders into FirearmCart
Order sync Keep order statuses synchronized, automatically every 30 minutes
Delist when sold out Automatically end a product’s listings when it runs out of stock (opt-in)
Auto-relist Automatically relist items that go unsold (opt-in)
Category browsing Browse GunBroker categories when creating listings
Webhook support Receive real-time notifications from GunBroker

Prerequisites

Before connecting, you need:

  • Active GunBroker seller account
  • GunBroker username and password
  • Valid FFL license (for firearms listings)

You don’t need a GunBroker Developer Key (Dev Key). FirearmCart connects with its own unless you enter one GunBroker issued you.


Setting Up

  1. Navigate to Plugins > Marketplace
  2. Find GunBroker
  3. Click Activate
  4. Enter your credentials:
    • Dev Key (optional) — Leave blank to connect with FirearmCart’s developer key, or enter your own if GunBroker issued you one
    • Username — Your GunBroker account username
    • Password — Your GunBroker account password
    • Enable Sandbox Mode — Tick for testing (clear for live listings)
  5. Click Activate Plugin

Your credentials are verified against GunBroker before the plugin activates — a failure blocks activation with “Unable to authenticate with GunBroker. Please verify your username and password, and your Dev Key if you entered one.” Once active, a GunBroker entry appears under Plugins in the sidebar.

To switch from your own Dev Key to FirearmCart’s, click Configure on GunBroker in Plugins > Marketplace, clear the Dev Key field and click Save.


Webhooks

GunBroker pushes real-time notifications (item sold, item unsold, winning bid, order status update, listing failed) to FirearmCart. GunBroker has no API for managing webhook subscriptions, so this is a one-time manual step:

  1. Open Plugins > GunBroker > Settings and find the Connection card
  2. Copy the callback URL and event list shown there
  3. Add them in GunBroker under Selling → Webhooks

Without webhooks configured, listing status changes and auto-relist rely on the scheduled polling jobs instead.


Creating Listings

Single Listing

  1. Navigate to Plugins > GunBroker
  2. Click the Create Listing tab
  3. Search for and select a product from your catalog
  4. Configure the listing:
Setting Description
Category GunBroker category — drilled down through Subcategory selects until you reach a leaf
Listing Type Fixed Price or Auction
Price / Starting Bid List price for fixed price, or opening bid for auctions
Buy Now Price (optional) Auctions only. A price a buyer can pay to win the item right away; must be at least the starting bid and any reserve. A fixed-price listing’s price already works this way
Reserve Price (optional) Auctions only. The lowest price you’ll sell at; must be higher than the starting bid, and isn’t allowed on 1 or 3 day auctions
Quantity Number of items available
Duration (days) 30 / 60 / 90 for fixed price; 1 / 3 / 5 / 7 / 14 for auctions
Offer free shipping (seller pays) Advertise the listing as free shipping
Auto-relist unsold items Relist automatically when the item goes unsold
Description Rich-text listing description
Premium Features (optional) Subtitle, Colored Title, Scheduled Start and other GunBroker paid upgrades
  1. Click Create Listing

Tip: The listing is created in the background. Refresh the listings tab to see the updated status. If GunBroker rejects the listing, it shows Failed. Hover the badge to see GunBroker’s reason (on mobile, it’s shown on the listing card).


Importing Existing Listings

If you already had listings on GunBroker before connecting (for example, listings you created directly on GunBroker.com), use Import existing on the Listings tab to link them to your FirearmCart catalog.

The import runs in the background, so it won’t time out on large accounts — matched listings appear in the table live as they’re linked, and you’ll get a notification when it finishes.

The importer scans your active GunBroker listings and matches each one against a single key, chosen by the Match products by setting on the Settings tab:

  • SKU — the listing’s SKU matched against your product SKUs (case-insensitive, whitespace ignored).
  • UPC — the listing’s UPC matched against your product barcodes (digits only).

There is deliberately no fallback to the other key: if the chosen key doesn’t match, the listing is reported as unmatched rather than guessed at. (Manufacturer part number is used as an extra fallback only when auto-creation is enabled.)

When a listing is matched, it’s linked to the product without creating a duplicate listing on GunBroker — it adopts the existing GunBroker item. Once linked:

  • The listing appears on the Listings tab and stays status-synced.
  • If you’ve enabled Delist when sold out, the listing is ended automatically when the product runs out of stock.
  • Sales from that listing import as orders, even when the item’s SKU is missing or is on more than one of your products.

Why this matters: A sale from a listing that isn’t linked imports only when exactly one of your products has the item’s SKU (or UPC). Linking your listings makes sure their sales reach your store. See How Sales Are Matched to Products.

What gets skipped

Outcome What happens
Unmatched No product matches on the configured key. The listing is left untouched and reported so you can add the SKU/UPC to the product (or create it) and re-run the import.
Ambiguous The key matches more than one product. The importer won’t guess — it skips and reports the candidates so you can resolve the duplicate.
Already linked The listing already has a local record (yours or from a previous import). Left as-is.

Tip: Re-running the import is safe — already-linked listings are skipped, so you can fix unmatched products and import again to pick up the rest.


Managing Listings

Listings Tab

View and manage all your GunBroker listings:

  • Search by product name or GunBroker item ID
  • Filter by listing status
  • Refresh listing statuses from GunBroker

Each listing’s actions are in the ⋯ menu at the end of its row:

Action Available for
View on GunBroker Listings that are on GunBroker
Edit Listing Active and scheduled listings: title, price, quantity and description
End Listing Active listings. Ends the listing on GunBroker
Relist Ended and unsold listings
Delete Listings that never reached GunBroker, such as failed ones

Listing Statuses

Status Description
Pending Listing is being created
Scheduled Created with a scheduled start that hasn’t arrived yet
Active Listed and visible on GunBroker
Sold Item has been sold
Unsold Listing ran its course without selling
Ended Listing was ended, manually or by the delist-when-sold-out rule
Failed The listing couldn’t be created on GunBroker; hover the badge for the reason

The status filter also has a Not imported option — GunBroker listings that are live on your account but have no local record yet.

When GunBroker Relists a Listing

GunBroker gives a relisted item a new item ID. At the next listing sync, within about 10 minutes, FirearmCart moves the listing onto the new item. It goes back to Active, View on GunBroker opens the new item, and Auto-Delist When Product Sells Out still covers it. If that setting is on and the product sold out in the meantime, the new item is ended right away.

If you already imported the new item as its own listing, the old listing stays Unsold.


Orders

Syncing Orders

Orders sync automatically every 30 minutes. To pull them in immediately:

  1. Navigate to Plugins > GunBroker
  2. Click the Orders tab
  3. Click Sync Orders to import new orders from GunBroker

Orders are imported into FirearmCart with buyer details, pricing, and FFL information (when applicable). Only orders GunBroker reports as paid, completed or shipped are imported.

How Sales Are Matched to Products

Each item in a GunBroker order is matched to one of your products:

  1. By SKU. The one product with the item’s SKU, or its UPC if Match products by is set to UPC.
  2. By listing. If the item has no SKU, or the SKU is on more than one product, a listing linked in FirearmCart decides.
  3. By creating a product. If none of your products has the SKU, FirearmCart creates one from the linked listing, or from the GunBroker item when Auto-create missing products is on.

Items that match none of these ways are left out of the order, and an order with none of your products isn’t imported: those are sales you manage outside FirearmCart.

Orders That Need a Product

When an item’s SKU is on more than one of your products and no linked listing decides, FirearmCart can’t tell which product sold. The order waits instead of importing:

  • It’s listed first on the Orders tab with the status Needs product, and the Orders page says how many are waiting.
  • You get the GunBroker order needs a product alert, in the dashboard and by email unless you’ve turned either off. See Notifications.

To import it:

  1. Click Choose product on the order, or open the link in the alert.
  2. For each item, pick the product that sold.
  3. Click Import order.

The order then imports like any other GunBroker order. If you handled the sale outside FirearmCart, click Don’t import instead, and it’s removed from the list.

To have later sales import on their own, give the other product a different SKU. An order that’s waiting then imports at the next sync, within 30 minutes. If the buyer’s order is cancelled, returned or refunded on GunBroker first, it shows that status and isn’t imported.

Order Details

Imported orders include:

Field Description
GunBroker Order ID Original order number from GunBroker
Buyer info Buyer name and contact details
Item details GunBroker item ID and pricing
FFL information Buyer’s FFL details for firearms transfers
Shipping address Delivery address
Status Current order status

Settings

The Settings tab has several cards.

Default Listing Settings

Setting Description
Default Listing Type Fixed Price (default) or Auction
Default Duration (days) Default listing duration — 7 by default
Auto-Relist Unsold Items Default auto-relist preference for new listings — off by default
Auto-Delist When Product Sells Out Off by default. When a tracked product hits zero stock from an order, end any active GunBroker listings for it and notify the team. Prevents overselling.
Accepted Payment Methods Which payment methods your listings advertise

Product Matching

Setting Description
Match products by SKU or UPC: the single key used to match listings and sold items to your products. See How Sales Are Matched to Products.

Customer Emails

Control whether imported GunBroker orders send your store’s order confirmation and tracking emails to the buyer. Send order confirmation email also covers the FOID card reminder for orders that need a card the buyer hasn’t uploaded. Send FOID request on the order page works either way.

Connection

Read-only. Shows the connected account and the webhook callback URL to paste into GunBroker. Credentials are changed from the marketplace, not here.

Product Auto-Creation

When you import existing listings, some may not match any product in your FirearmCart catalog (a different SKU, no UPC, or simply never added). The Product Auto-Creation card on the Settings tab controls what happens to those:

Setting Description
Auto-create missing products Off by default. When on, the import builds a product from any listing that matches no catalog product by SKU, UPC, or manufacturer part number. Existing products are never duplicated — a listing that already matches a product links to that product instead. Turning this on also enables part-number fallback matching, which is otherwise off.
New product status Draft (recommended) or Active. Draft keeps the new products out of your storefront until you review them — sellers sometimes list things on GunBroker that aren’t real catalog products.
Import listing images On by default. Pulls the GunBroker listing’s photos onto the new product.
Lock suppliers (standalone product) Off by default. Keeps auto-created products from being adopted by distributor catalog syncs.

Auto-created products carry the listing’s title, price, SKU, UPC (as the barcode), and specifications (caliber, manufacturer, part number, round count). After enabling, run Import existing on the Listings tab to create + link them so their orders import.

Tip: Leave New product status on Draft the first time. New products are created hidden from your storefront, so you can review them on the Products page — publish the ones you want and delete any that aren’t real catalog items — before anything goes live.


Troubleshooting

Connection Failed

Symptoms: Activation is refused with “Unable to authenticate with GunBroker”

Solutions:

  • Verify your username and password, and your Dev Key if you entered one
  • Ensure your GunBroker account is active
  • Check if sandbox mode matches your credentials (sandbox credentials won’t work in production and vice versa)

Listing Creation Failed

Symptoms: Listing shows “Failed” status

Solutions:

  • Hover the Failed badge on the Listings tab (on mobile, read the listing card) to see GunBroker’s own explanation of what it didn’t accept
  • Fix the issue, delete the failed listing from its menu, and create the listing again
  • Check that the product has all required fields (title, description, price)
  • Verify the selected GunBroker category is valid
  • Ensure your account has seller privileges

Orders Not Syncing

Symptoms: GunBroker orders not appearing in FirearmCart

Solutions:

  • Click Sync Orders to manually trigger a sync
  • Verify the plugin connection is active
  • Check that orders exist in your GunBroker seller account
  • Look for the order on the Orders tab with the status Needs product: the item’s SKU is on more than one of your products, so choose which one sold. See Orders That Need a Product.
  • Check that one of your products has the item’s SKU, or link the listing with Import existing on the Listings tab. Sales of items that match none of your products aren’t imported.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close