Create Collection

OverviewCopy Anchor Link

Creates a new collection for the authenticated member. Collections allow members to organize their favorited properties into groups like "Honeymoon Destinations", "Business Travel", or "Weekend Getaways".

AuthenticationCopy Anchor Link

Requires a valid Clerk JWT token in the Authorization header.

Request BodyCopy Anchor Link

curl -X POST "http://localhost:3000/v1/members/me/collections" \
  -H "Authorization: Bearer YOUR_CLERK_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Honeymoon Destinations",
    "notes": "Romantic properties for our upcoming honeymoon trip"
  }'

ResponseCopy Anchor Link

{
  "id": 5,
  "externalId": "coll_789xyz",
  "name": "Honeymoon Destinations",
  "notes": "Romantic properties for our upcoming honeymoon trip",
  "isSystem": false,
  "itemCount": 0,
  "items": [],
  "createdAt": "2024-04-20T15:30:00Z",
  "updatedAt": "2024-04-20T15:30:00Z"
}

Collection NamingCopy Anchor Link

RequirementsCopy Anchor Link

• Length: Must be 255 characters or less
• Required: Name cannot be empty
• Uniqueness: Names don't need to be unique per member

Best PracticesCopy Anchor Link

• Descriptive: Use clear, descriptive names
• Organized: Consider themes like "Business Travel", "Family Vacations"
• Personal: Make them meaningful to your travel planning

Collection LimitsCopy Anchor Link

While there's no hard limit on the number of collections a member can create, consider:

• Practical Limits: Too many collections can become difficult to manage
• Performance: Very large numbers may impact load times
• User Experience: Focus on meaningful organization

Next StepsCopy Anchor Link

After creating a collection, you can:

1. Add Favorites: Use Add Favorite to add properties

Related EndpointsCopy Anchor Link

• Get Collections - List all collections
• Add Favorite - Add properties to collections