---
title: "Create a collection in the MDM"
method: PUT
path: "/mdm/v1/collections/{collectionKey}"
tags: ["Collections"]
---

# Create a collection in the MDM

`PUT /mdm/v1/collections/{collectionKey}`

Create a collection in the MDM.

## Path parameters

- `collectionKey` string, required

## Request body

- object
  - `profile` V2MDMProfile, required
    - `sourceProfiles` V1SourceProfile[], required — The source profiles used by the mdm profile.
      - `source` string, required
      - `type` string, required
  - `resolutionRule` V1ResolutionRule
    - `resolvers` object, required
    - `matchers` object, required
    - `properties` object, required — The properties used in the resolution rule.
    - `mappings` V2PropertyMappings[], required
      - `source` string, required
      - `type` string, required
      - `paths` object, required — Maps one or multiple properties with the following format: `{rulePropertyKey: sourcePropertyPath}` The source property path is a dot separated path to the source property. It can include a contained key to reference a property in a contained resource.

## Response `201`

A successful response when the collection was created.

- V1Collection
  - `key` string
  - `profile` V2MDMProfile, required
    - `sourceProfiles` V1SourceProfile[], required — The source profiles used by the mdm profile.
      - `source` string, required
      - `type` string, required
  - `resolutionRule` V1ResolutionRule
    - `resolvers` object, required
    - `matchers` object, required
    - `properties` object, required — The properties used in the resolution rule.
    - `mappings` V2PropertyMappings[], required
      - `source` string, required
      - `type` string, required
      - `paths` object, required — Maps one or multiple properties with the following format: `{rulePropertyKey: sourcePropertyPath}` The source property path is a dot separated path to the source property. It can include a contained key to reference a property in a contained resource.

## Other responses

- `400` — Returned when the request is malformed or invalid.
- `409` — Returned when the collection already exists.
- `413` — Returned when the payload exceeds the max content size (100kB).

---

[API](https://skmtc.net/clinia/apis/mdm-api.md) · [All operations](https://skmtc.net/clinia/apis/mdm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinia/mdm-api/versions/0ea93fa84bac/schema)