Skip to main content
Your platform displays the catalog and collects the order, Snappy handles the fulfillment. Bring Snappy’s curated catalog of gifts and swag into your own platform. Build a dedicated gifting store from scratch, or seamlessly add Snappy’s global products to your existing marketplace. You control the UI - whether it’s a new redemption center or an existing e-commerce shop - and Snappy acts as the invisible fulfillment engine.
Want recipients to choose their own gift from a Snappy-hosted claim page instead? See Triggered Gifting.

​
Common Use Cases

​
Embedded Rewards Marketplace

Allow employees or customers to redeem loyalty points for physical products directly within your own portal. You control the branding, point values, and display; Snappy handles the logistics and shipping.

​
Procurement & Swag Stores

Build an internal company store where office managers can order branded swag or equipment for their teams directly, with instant order placement.

​
How it works

1

Catalog Retrieval

Pull product data via the V3 Catalog API to display items in your own UI. There are two integration patterns - pick the one that fits your traffic and UX:
  • Real-time queries - hit GET /v3/products, GET /v3/variants, and GET /v3/collections/{collectionId}/products on demand to browse, filter, and paginate directly against Snappy. Best for low-volume integrations or browse-as-you-go experiences where the catalog is rendered fresh per request.
  • Bulk catalog mirror (async export) - kick off a background job via POST /v3/products/exports (or POST /v3/collections/exports for a single collection), poll GET /v3/products/exports/{exportId} for completion, and download the full result as a single NDJSON file. Best for high-volume integrations, local search and filtering, or partners maintaining their own product database. See the Export API for the full reference.
Recommended pattern for production partners: run a nightly async export to refresh your catalog mirror, and subscribe to the stock-availability-updates webhook for incremental inventory changes between exports.
2

User Selection

The user chooses a product and variant in your UI. Your system captures the shipping address (from the user’s profile or input form) and optionally validates per-country availability using GET /v3/variants/{variantId}/availability.
3

Order Placement

Pass the chosen variant and recipient details to POST /v3/orders in a single idempotent call. Snappy returns an order with a tracking link and emits webhooks for every status change.

​
Key Features

  • Comprehensive catalog access - browse, filter, expand, and paginate Snappy’s full catalog via the V3 Catalog API in real time.
  • Bulk catalog ingestion - mirror the entire catalog (or any filtered subset) into your own database via the async Export API. Export jobs return signed NDJSON download URLs, valid for 48 hours. Pair with webhooks for incremental refresh between full snapshots.
  • Single-call order placement - variant + recipient → order in one API call. Built-in idempotency via idempotencyKey prevents duplicates on replay.
  • Full order management - retrieve, list, and cancel orders programmatically. Tag orders for reporting and attach metadata to round-trip your internal IDs.

​
Core Platform Capabilities

The following capabilities apply to all Snappy integration models. Global Reach Send gifts to recipients in over 30 countries. Snappy handles currency conversion, local sourcing, and international logistics automatically. Real-Time Tracking Track the full lifecycle of every order - from order received to delivered - using Snappy’s comprehensive Webhooks system. Order-level webhooks fire alongside gift-level webhooks for V3 orders. Enterprise Security Scoped API keys, granular per-endpoint permissions, PII masking on order reads, and optional mTLS for enterprise integrations. See Authentication & Security. Standards-Based Integration Connect through standardized RESTful API endpoints with JSON:API conventions for filtering, expansion, pagination, and sorting on V3.

Ready to integrate?

See the step-by-step Embedded Marketplace walkthrough with code samples (JavaScript, Python, cURL) in the API Recipes guide.
Last modified on June 18, 2026