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"
}