Guns.com is a leading online marketplace specializing in firearms, ammunition, and related accessories. By connecting your Guns.com account as a channel in Flxpoint, you can manage product listings, inventory, and orders directly from your centralized catalog. This integration ensures accurate syncing and helps maintain compliance with Guns.com’s approved listing requirements.
How to connect
📋 Phase A — Create & Connect Guns.com (Steps 1–3)
+
Create the channel
Go to Channel on the left panel, then click ¨+¨ to Create a Channel. Search for Guns.com and Name it (e.g., guns.com) and enable:
- ✔ Sync Listings
- ✔ Publish Listings
- ✔ Get Orders
Authenticate the connection
In Connect Channel, enter:
- API Username
- API Password
- Environment (Guns.com API)
Confirm integrations
Verify Get Orders, Publish Listings, and Sync Listings are enabled. Check the box and select Save & Next.
⚙️ Phase B — Pricing, Fulfillment & Automation (Steps 4–6)
+
Pricing & Quantity Rules
Configure your rules under Pricing & Quantity. If none exist, the Product Variant Default List Price will be used.
Order Fulfillment overview
A short Flxpoint video covers fulfillment inside Flxpoint.
Advanced Workflows
Choose whether to enable automated rules for listing statuses, orders, and/or invoices now or later in Automate Integrations.
📊 Phase C — Channel Dashboard
+
Available actions
From the guns.com channel page you can run:
- Import Listings
- Get Orders
- Publish Listings
- Sync Listings
- Send Accounting Shipments
📚 Tips & Next Steps
+
Run each process once manually after setup to validate a few products and an order before enabling schedules.
Listing Operations
Sync & Link Listings
Supported | Guns.com – Sync & Link Listings
Introduction
Yes — syncing and linking listings with Guns.com is supported. This process keeps price and quantity updated on active Guns.com listings and links your Flxpoint listings to the correct Guns.com items using your chosen identifiers.
Where to do this: You can complete Sync & Link during the How to Connect wizard (Step 2: Configure Settings & Step 3: Mapping Template), or later via Sales Channels → Guns.com → Sync Listings.
Flxpoint’s Guns.com Sync & Link:
- Updates Price and Quantity on Guns.com for your linked listings.
- Links your Flxpoint listings to existing Guns.com listings based on your Linking Priority (e.g., SKU, then UPC).
- Can delist or hide items on Guns.com when appropriate (e.g., zero quantity / product hidden in Flxpoint).
Use the Linking Priority control to define how Flxpoint attempts to match your products to Guns.com:
- Start with SKU when possible.
- Add UPC as a fallback if SKU is not present on both sides.
- Ordering matters — the app will try from top to bottom until a match is found.
Important Update on Linking Behavior
When syncing and linking listings with Guns.com, Flxpoint will now only link to approved (active) listings.
Previously, the system could link by UPC even if the match was inactive. With this update:
When syncing and linking listings with Guns.com, Flxpoint will now only link to approved (active) listings.
Previously, the system could link by UPC even if the match was inactive. With this update:
- Only approved Guns.com listings are eligible to link.
- Inactive listings are ignored, even if they share the same UPC as an active listing.
Create or open your Guns.com Sync Products template and map the required fields:
Required / Recommended
- Quantity → Guns.com Quantity (required).
- List Price (or your chosen price field) → Guns.com Price (recommended).
Mapping Options
- Don’t Map — ignore a field.
- Set To Empty — clear a field value on the channel.
- Field — choose a Flxpoint field (e.g., Listing Variant → Quantity / List Price).
- Value — send a constant value.
| Flxpoint Source | To Guns.com Field | Example | Status |
|---|---|---|---|
| Listing Variant → Quantity | Quantity | 5 | Required |
| Listing Variant → List Price (or MSRP) | Price | 599.99 | Recommended |
Tip: If Quantity isn’t mapped, syncs can fail for active items. Map both Quantity and Price, save the template, then re-run the job.
Behind the scenes Flxpoint:
- Loops your channel listings and updates price and quantity for each listed item.
- Links only to approved Guns.com listings when matching by your priority (SKU → UPC).
- Supports delisting/hide flows when items are out of stock or hidden in Flxpoint.
PUT /api/v1/items/{listing_id}
DELETE /api/v1/items/{listing_id}
DELETE /api/v1/items/{listing_id}
- Click Save and Complete, then Run Integration to push updates.
- Optional: enable Scheduled runs to keep prices and inventory current (times are UTC).
- Linking didn’t occur: Confirm your Linking Priority fields exist on both sides (e.g., SKU on Guns.com).
- Quantity/Price not updating: Re-check the Mapping Template; ensure Quantity (required) and Price are mapped, then re-run.
- Delist/hide: Verify the item is zero quantity or hidden in Flxpoint if you expect a removal.
Done
You’ve set up Guns.com Sync & Link. Your listings will link to approved Guns.com items and stay updated with the latest price and quantity from Flxpoint.
Publish Listings
Supported | Guns.com – Publish Listings
Introduction
Yes — publishing new products to Guns.com is supported. Use this flow to create new Guns.com items (e.g., brand-new UPC-based offers) and to publish used items that fit Guns.com’s predefined categories.
Where to do this: Complete Publish Listings inside the How to Connect wizard (Steps 2–3), or later via
Sales Channels → Guns.com → Publish Listings.
- 1Connect an Integration — choose your Guns.com connection.
- 2Configure Settings — this step has no additional settings for this flow; click Save and Proceed.
- 3Define a Mapping Template — map your Flxpoint fields to Guns.com product fields, then Save and Complete.
Tip: After setup, click Run Integration or enable the schedule to automate publishing (UTC).
New Items
- UPC is required for new items. If a UPC is missing, the API call is blocked to avoid errors.
- Guns.com treats UPC as the product’s unique key (SKU is internal to Guns.com).
- Quantity can be any non-negative value (≥ 0) for new items.
- Images: for many new items, Guns.com can use their predefined UPC images.
Used Items
- Main Category (required): handguns, shotguns, or rifles.
- Subcategory (required): bolt action, lever action, over under, pump action, semi auto, single shot, side by side, derringer, or revolver.
- Quantity is always 1 per listing.
- Images are required (custom images you provide).
Unsupported in Publish
- Variations/options, attributes/tags, custom fields.
- Client-specific pricing, multiple warehouses, weights & dimensions (fixed/mapped by Guns.com).
Offerings vs Creation: New items are created via an existing UPC offering when available; used/custom items without UPC can be created but must fit the predefined categories.
Create/open your Guns.com Publish Products template and map at least the required fields shown below.
Core Fields to Map
| Flxpoint Source | To Guns.com Product Field | Example | Status |
|---|---|---|---|
| Listing Variant → Title | Title | Smith & Wesson M&P 9 | Required |
| Listing Variant → Description | Description | Factory new pistol with … | Recommended |
| Listing Variant → Brand | Brand | Smith & Wesson | Recommended |
| Listing Variant → List Price / MSRP / MAP | Price | 599.99 | Required |
| Listing Variant → Quantity | Quantity | 5 (new) / 1 (used) | Required |
| Listing Variant → UPC (new items) | UPC | 022188129944 | Required for New |
| Listing Parent → Condition | Condition (New/Used) | New | Required |
| Listing Parent → Category 1/2/3 (used) | Main/Sub Category | Rifles → Bolt Action | Required for Used |
| Listing Variant → Image | Images | 1–5 URLs | Required for Used |
Mapping Options You’ll See
- Don’t Map / Set To Empty / Field / Value options per row.
- Template header controls for Save, Duplicate, and Delete.
- Layout labeled From Value → To Guns.com Product Field.
Reminder: If publishing a used item, ensure Condition=Used, categories are mapped, quantity=1, and at least one image is provided.
- Flxpoint sends POST requests to create items on Guns.com.
- The saved external reference is the Guns.com listing_id.
- If a listing already exists, we update/overwrite by listing_id when needed.
- Auth endpoints:
Sandbox — https://auth-sandbox.guns.com
Production — https://auth.guns.com
POST /api/v1/items # Create new Guns.com items
PUT /api/v1/items/{listing_id} # Overwrite/update existing listing by listing_id
PUT /api/v1/items/{listing_id} # Overwrite/update existing listing by listing_id
- Missing UPC (New): The request won’t be sent — add a valid UPC.
- Used item rejected: Ensure Main Category + Subcategory are mapped and an image is provided.
- Unexpected quantity: Used items must publish with quantity 1.
- Fields not showing on Guns.com: Re-check your template mappings and re-run.
Done
Your Guns.com Publish Listings setup is complete. New and used items will publish according to your mappings and the rules above.
Order Operations
Get Orders
Supported | Guns.com – Get Orders
Introduction
Yes — retrieving orders from Guns.com is supported. You can configure this during the How to Connect wizard or later from
Sales Channels → Guns.com → Get Orders. The process brings in order, payment status, shipment destination (FFL), and customer/PII fields based on your template and retention settings.
- 1Connect an Integration — select your Guns.com API connection.
- 2Configure Settings — choose one or more Order Statuses to import (multi-select), and set Personal Identifying Information (PII) Retention.
- 3Define a Mapping Template — map incoming Guns.com order fields to your target structure, then Save and Complete.
Where to run: Click Run Integration to fetch orders on demand, or enable a schedule (UTC) for automatic pulls.
Order Status Filters (Multi-Select)
- All (default), or select specific statuses such as Awaiting Confirmation, GDC Processing Order, Pending Shipment / Ready to Ship, Shipped, Delivered, Canceled.
- Guns.com’s API accepts one status per call; Flxpoint handles multiple selections by iterating those statuses on the backend for you.
Advanced: PII Retention
- Choose how long to keep personally identifying information (e.g., Indefinitely, 30 days, 90 days). After the retention period, PII fields are redacted in Flxpoint.
Create/open your Guns.com Get Order template. The UI presents From Value → To … Field with options:
Don’t Map, Set To Empty, Field, Value, and Mapping Set.
Common Groups & Fields
| Group | Key Fields | Notes |
|---|---|---|
| Guns.com Order | Order ID, Order Date, Status, Payment | Order/payment statuses are supported; currency is USD. |
| Billing Address | First/Last Name, Street, City, State, Zip, Phone, Email | Subject to your PII retention setting. |
| Shipping Address | First/Last Name, Street, City, State, Zip, Phone, License | Includes destination FFL details when applicable. |
| Order Item | Order Item ID, Listing ID, Amount, Serial Number | Serial Number appears on firearm items when provided. |
| FFL | FFL ID, Name, Business Name, Street, City, State, Zip, Phone, Expiration Date | Used to capture the receiving dealer’s information. |
Tip: Keep a lightweight template for routine ops (Order, Item, Status) and a detailed template with FFL + full addresses for CS/Compliance.
- Orders are fetched in batches of up to 100 using a date filter (Since) and the selected status(es).
- Flxpoint runs separate pulls per selected status and imports all matching orders.
- Auth endpoints:
Sandbox — https://auth-sandbox.guns.com
Production — https://auth.guns.com
Sample request pattern
GET /orders?PageSize=100&OrderStatus=ready_to_ship&Since=YYYY-MM-DD
Shipping Selection: Guns.com customers may have unique shipping methods. Map these within your Shipping Management as needed.
- No orders imported: Widen the Since date range and verify the selected statuses contain recent orders.
- Missing address/PII: Confirm your PII Retention hasn’t elapsed and that those fields are mapped in the template.
- Mismatched shipping/FFL: Map FFL and shipping fields (and license) to your order destinations.
Done
Your Guns.com Get Orders setup is complete. Run it on demand or schedule it to keep your orders up to date.