## Create a collection

`POST https://getkollek.com/api/collections`

Create a collection: a named set of items being catalogued, such as My Comics or Vinyl.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Body parameters

- `name` (string, required): The name of the collection. Maximum 255 characters.
- `description` (string, optional): A description of the collection. Maximum 2000 characters.
- `emoji` (string, optional): The emoji shown next to the collection name. One of 📦, 📚, 💿, 🃏, 🍷, 🎮, 🧸, 🪙, 🖼️, ⌚, 👟 or 📷.
- `visibility` (string, required): Who the collection is meant for. One of private (you alone), shared (everyone in the account) or public (anyone with the link, read only). The setting is recorded but not enforced yet: every member of the account can read every collection, and public collections have no link to hand out, so nothing is reachable from outside the account.
- `currency` (string, optional): The three-letter currency code used for item values, such as USD or EUR.
- `collection_type_ids` (array of integers, optional): The IDs of the collection types to link to the collection. IDs that do not belong to your account are ignored.

**Returns:** The created collection object.

### Example request

```bash
curl https://getkollek.com/api/collections \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Comics",
    "description": "Silver age Marvel issues.",
    "emoji": "📚",
    "visibility": "private",
    "currency": "USD",
    "collection_type_ids": [
        1
    ]
}'
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "collection",
        "id": "1",
        "attributes": {
            "uuid": "9e2f6c1a-4b3d-4b6e-9a2f-0c1d2e3f4a5b",
            "name": "My Comics",
            "description": "Silver age Marvel issues.",
            "emoji": "📚",
            "visibility": "private",
            "currency": "USD",
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/collections/1"
        }
    }
}
```