---
title: "Create new collection"
method: POST
path: "/v2/bulk-user-operation/collection"
tags: ["Bulk Operation Collection"]
---

# Create new collection

`POST /v2/bulk-user-operation/collection`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/bulk-user-operation/collection`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/bulk-user-operation/collection/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new collection. This endpoint can take two content types -- application/json and multipart/form-data. Please see the request body examples for the content type you will be using.

## Request body

- CollectionDTO
  - `id` string: Unique identifier of the collection
  - `ownerId` string: Owner identifier of the collection
  - `size` integer: Size of the collection
  - `transformObjectType` string, required: Type of the transform object
  - `transformObjects` object[], required
  - `createdDateTime` string, date-time: Timestamp of the creation in ISO 8601 format
  - `deleteDateTime` string, date-time: Timestamp of the deletion in ISO 8601 format

## Response `200`

Collection created successfully

- CollectionDTO
  - `id` string: Unique identifier of the collection
  - `ownerId` string: Owner identifier of the collection
  - `size` integer: Size of the collection
  - `transformObjectType` string, required: Type of the transform object
  - `transformObjects` object[], required
  - `createdDateTime` string, date-time: Timestamp of the creation in ISO 8601 format
  - `deleteDateTime` string, date-time: Timestamp of the deletion in ISO 8601 format

## Other responses

- `400`: Invalid collection details supplied
- `403`: Unauthorized access
- `422`: associated collection has pre-validation errors

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)