---
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

---

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