Skip to main content
A Collection is a curated catalog of gift items tailored to a specific theme, budget range, and audience (e.g., “Birthday Gifts Under $50”). The gift recipient then chooses their preferred item directly from this collection.
Want to understand how Collections fit into the bigger picture? Check out the Core Concepts & Data Models page.

​
The Collection Object

​
Paginated Response

The Collections endpoint returns a paginated response with the following envelope:
For details on how to paginate through large result sets, see Request & Response Standards → Pagination.

​
Key Concepts & Business Rules

​
Collections are read-only via the API

Collections available to your account are curated by Snappy or created via the Snappy Dashboard. You cannot create or modify Collections through the API - only retrieve them.

​
Collection types

The types field indicates the category of items within the Collection. This can be useful for filtering Collections when configuring a Campaign for a specific use case - for example, selecting only swag Collections for a branded merchandise campaign.

​
Assigning a Collection to a Campaign

To use a Collection in a gifting flow, assign its id to a Campaign. Recipients will then browse and select from that Collection when they claim their gift.
A Campaign can be assigned either a Collection or a specific Product - not both. See Campaigns for details.

​
How to Work with Collections

Retrieving Collections Search for and retrieve a list of available Collections based on your specified criteria:
Filtering options:
  • Budget range
  • Supported countries
  • Collection types (e.g. gifts, swag)
Swag collections can only be retrieved by specifying the accountId in the request.
Retrieving Collection Budgets Retrieve the available minimum and maximum budget ranges for Collections. Budget ranges determine the price points that recipients can choose from when selecting gifts:
Filtering options:
  • Budget range
  • Supported countries
Retrieving Products within a Collection Retrieve a list of products available within a specific Collection:
Filtering options:
  • Budget range
  • Supported countries
Retrieve a specific product from a specific Collection:
The Product objects returned in this response follow the standard Product schema. See Products for the full object structure.
Retrieving the Collection Products Count Retrieve the number of products available within a specific Collection - useful for display purposes or pagination planning before fetching the full product list:
Last modified on June 18, 2026