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
- Navigate to Plugins > Marketplace
- Find GunBroker
- Click Activate
- 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)
- 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:
- Open Plugins > GunBroker > Settings and find the Connection card
- Copy the callback URL and event list shown there
- 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
- Navigate to Plugins > GunBroker
- Click the Create Listing tab
- Search for and select a product from your catalog
- 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 |
- 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:
- Navigate to Plugins > GunBroker
- Click the Orders tab
- 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:
- By SKU. The one product with the item’s SKU, or its UPC if Match products by is set to UPC.
- By listing. If the item has no SKU, or the SKU is on more than one product, a listing linked in FirearmCart decides.
- 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:
- Click Choose product on the order, or open the link in the alert.
- For each item, pick the product that sold.
- 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.
Related Documentation
- Orders - Order management
- Products - Product catalog
- FFL Compliance - FFL requirements for firearms sales
- Webhooks - Webhook event notifications

