> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snappy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Introduction to Snappy's guides - foundational patterns, vertical recipes, and migration references for building on the Snappy API.

Snappy's Guides are organized in two tiers:

**Patterns** — focused, reusable building blocks for a single capability. Each pattern covers one thing in depth: how to access the catalog, how to place an order, how to track fulfillment. They're designed to be combined.

**Recipes** — end-to-end vertical walkthroughs that assemble patterns into complete integration guides. A recipe walks you from zero to working integration for a specific use case.

## Patterns

### Catalog Access

* [Real-Time Catalog Access](/patterns/real-time-catalog-access) — Serve Snappy's V3 catalog on demand with live API calls (and optional edge caching). No local mirror, no sync jobs.
* [Bulk Catalog Export](/patterns/bulk-catalog-export) — Export the full catalog asynchronously and maintain a local copy. Queue a job, poll for completion, download the result.
* [Swag Products Access](/patterns/swag-products-access) — Access Snappy's swag catalog. Requires the `Snappy-Account-Id` header and swag-specific filters.

### Orders

* [Place Orders](/patterns/place-orders) — Place direct-fulfillment orders via `POST /v3/orders`. Covers address validation, idempotency, bulk placement, and the Swag variant.
* [Track Order Fulfillment](/patterns/track-order-fulfillment) — Subscribe to order webhooks and respond to fulfillment lifecycle events. Covers all four event types and delivery status transitions.

### Triggered Gifting

* [Send Triggered Gifts](/patterns/send-triggered-gifts) — Create gifts programmatically with `POST /v2/gifts`. Covers bulk chunking, idempotency keys, and partial failure handling.
* [Auto-claim Gifts as Fallback](/patterns/auto-claim-gifts-as-fallback) — Auto-claim a gift on the recipient's behalf when they don't claim it themselves. Covers the fallback flow, webhook cancellation, and 409 handling.

## Recipes

* [Build a Rewards Experience](/pages/marketplace) — An embedded marketplace: fetch the catalog, personalize a "For You" page, present products with variant selection, validate addresses, place orders, and track fulfillment.
* [Triggered Gifting](/pages/triggered-gifting) — Send gifts at scale programmatically: create gifts in bulk, handle idempotency, and manage the recipient experience through webhooks.

## Migration

* [Migrating V2 to V3](/pages/migrating-v2-to-v3) — Key differences between the V2 and V3 APIs: endpoint changes, pagination, authentication, and entity model updates.

<Check>
  Before you start, make sure you have:

  1. A valid API key with the scopes each guide requires (see [Quickstart](/quickstart) and [Authentication & Security](/authentication-and-security)).
  2. At least one Account with a configured Billing Method.
  3. For Triggered Gifting patterns: at least one Campaign configured in the Snappy Dashboard.
</Check>