---
title: "Share with people"
method: POST
path: "/collections/{collection_id}/share"
tags: ["Collections"]
---

# Share with people

`POST /collections/{collection_id}/share`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/collections/{collection_id}/share`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

## Path parameters

- `collection_id` integer, required

## Request body

- ShareCollectionPayload
  - `emails` string[], required

## Response `200`

Request fulfilled, document follows

- ShareCollectionResult
  - `added` string[], required
  - `already` string[], required
  - `in_project` string[], required: Skipped: they already edit this project's boards

## Other responses

- `400`: Bad request syntax or unsupported method

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)