---
title: "Add a collection"
method: POST
path: "/collections/add"
tags: ["Collections"]
---

# Add a collection

`POST /collections/add`

## Request body

- object
  - `uuid` string, uuid
  - `type` 'campaign' | 'intrusion_set' | 'named_threat' | 'other' | 'research'
  - `name` string
  - `description` string
  - `distribution` '0' | '1' | '2' | '3' | '4' | '5' — Who will be able to see this event once it becomes published and eventually when it becomes pulled: * `0` - Your organization only * `1` - This community only * `2` - Connected communities * `3` - All communities * `4` - Sharing group * `5` - Inherit Event
  - `sharing_group_id` union
    - string, nullable
    - string, uuid, nullable

## Response `200`

A collection

- object
  - `Collection` CollectionAddEdit
    - `id` string
    - `org_id` string
    - `orgc_id` string
    - `uuid` string, uuid
    - `created` string
    - `modified` string
    - `user_id` string
    - `type` 'campaign' | 'intrusion_set' | 'named_threat' | 'other' | 'research'
    - `name` string
    - `description` string
    - `distribution` '0' | '1' | '2' | '3' | '4' | '5' — Who will be able to see this event once it becomes published and eventually when it becomes pulled: * `0` - Your organization only * `1` - This community only * `2` - Connected communities * `3` - All communities * `4` - Sharing group * `5` - Inherit Event
    - `sharing_group_id` union
      - string, nullable
      - string, uuid, nullable

## Other responses

- `403` — Authentication failed. Please make sure you pass the API key of an API enabled user along in the Authorization header.
- `default` — Unexpected API error

## Changes

> 50 revisions in range; 1 could not be searched.

- **2025-12-11** `0a9c9382121a` — 5 breaking, 3 info
  - the request property `allOf[#/components/schemas/BaseCollection]/sharing_group_id` became not nullable
  - the `allOf[#/components/schemas/BaseCollection]/sharing_group_id` request property type/format changed from `string`/`` to ``/``
  - the `Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response property's maxLength was unset from `10` for the response status `200`
  - added `#/components/schemas/SharingGroupIntId, #/components/schemas/SharingGroupUuidId` to the `Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response property `oneOf` list for the response status `200`
  - …4 more
- **2025-04-09** `392ce38a6c1f` — 1 info
  - endpoint added
- **2024-07-11** `7cd8b1880b11` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/misp/apis/misp-automation-api/changes/collections/add/post.md)

---

[API](https://skmtc.dev/misp/apis/misp-automation-api.md) · [All operations](https://skmtc.dev/misp/apis/misp-automation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/misp/misp-automation-api/revisions/88b34ff032a1/schema)