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
Bulk listing List multiple products to GunBroker at once
Import existing listings Link listings you already had on GunBroker to your catalog by SKU/UPC
Order import Import GunBroker orders into FirearmCart
Order sync Keep order statuses synchronized
Delist when sold out Automatically end a product's listings when it runs out of stock (opt-in)
Auto-relist Automatically relist items when they expire
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 Developer Key (Dev Key)
  • GunBroker username and password
  • Valid FFL license (for firearms listings)

Getting API Credentials

  1. Log into your GunBroker account
  2. Request a Developer Key from GunBroker
  3. Note your GunBroker username and password

Setting Up

  1. Navigate to Settings > Plugins
  2. Find GunBroker
  3. Click Activate
  4. Enter your credentials:
    • Dev Key — Your GunBroker Developer Key
    • Username — Your GunBroker account username
    • Password — Your GunBroker account password
    • Sandbox — Enable for testing (disable for live listings)
  5. Click Save
  6. Use Load Account Info to verify the connection

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 for the listing
Listing type Fixed Price or Auction
Start price Starting price (auction) or list price (fixed)
Reserve price Minimum acceptable price (auction only)
Buy now price Instant purchase price (optional for auctions)
Quantity Number of items available
Duration Listing duration in days
Auto-relist Automatically relist when the listing expires
  1. Click Create Listing

Tip: The listing is created in the background. Refresh the listings tab to see the updated status.

Bulk Listing

Select multiple products and list them all to GunBroker at once using the bulk listing action.

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 to a product:

  1. By SKU — matched against your product SKUs (case-insensitive).
  2. By UPC — if no SKU match, the listing's UPC is matched against your product barcodes.

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 (previously, sales from unlinked listings were skipped).

Why this matters: Until a GunBroker listing is linked to a product, FirearmCart can't recognize its sales — so importing your existing listings is the step that brings their orders into your store.

What gets skipped

Outcome What happens
Unmatched No product has the listing's SKU or UPC. 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 SKU/UPC 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
  • End active listings
  • Relist expired or ended listings

Listing Statuses

Status Description
Pending Listing is being created
Active Listed and visible on GunBroker
Sold Item has been sold
Ended Listing was ended manually
Expired Listing duration has elapsed
Failed Listing creation failed

Orders

Syncing Orders

  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).

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

Configure default values for new listings:

Setting Description
Default listing type Fixed Price or Auction
Default duration Default listing duration in days
Auto-relist Default auto-relist preference

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 part number. Existing products are never duplicated — a listing whose SKU or UPC already belongs to a product links to that product instead.
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.

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: Cannot connect to GunBroker or "Load Account Info" fails

Solutions:

  • Verify your Dev Key, username, and password are correct
  • 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:

  • Check that the product has all required fields (title, description, price)
  • Verify the selected GunBroker category is valid
  • Ensure your account has seller privileges
  • Review the listing details for any validation errors

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