Free
Create Collection
Create a new card collection
What This Does
- Create a new collection for organizing cards
- Set collection name and description
- Returns the created collection with its ID
- Collection is owned by the authenticated user
When To Use This
- Starting a new collection for a specific theme
- Organizing cards into separate groups
- Setting up collections before adding cards
- Building collection management apps
Real Example
Scenario
You create a collection for your vintage baseball cards
Sample Request
POST
/v1/collection/Request Body
{
"name": "Vintage Baseball",
"description": "Pre-1990 cards"
}What You Get Back
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"collectorId": "550e8400-e29b-41d4-a716-446655440099",
"name": "Vintage Baseball",
"description": "Pre-1990 cards"
}