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
Order import Import GunBroker orders into FirearmCart
Order sync Keep order statuses synchronized
Inventory sync Sync listing statuses and quantities
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.

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

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