---
title: "Create a box"
method: POST
path: "/pipelines/{pipelineKey}/boxes"
---

# Create a box

`POST /pipelines/{pipelineKey}/boxes`

This call creates a [box](reference#get-a-box) based on the pipelineKey you provide.

## Path parameters

- `pipelineKey` string, required

## Request body

- object
  - `name` string, required — The name of this box
  - `stageKey` string — The stage of this box
  - `notes` string — The notes on the box
  - `assignedToSharingEntries` string — The member(s) of your team this box will be assigned to. This must be an array of objects with `email` properties encoded as a JSON string. Try this as an example: `[{"email":"ginny@weasley.com"}, {"email":"fred@weasley.com"}, {"email":"george@weasley.com"}]'`, keeping in mind that any assigned-to users must have access to the pipeline.

## Response `200`

200

- object
  - `pipelineKey` string
  - `creatorKey` string
  - `creationTimestamp` integer
  - `lastUpdatedTimestamp` integer
  - `name` string
  - `stageKey` string
  - `fields` object
  - `followerKeys` string[]
  - `followerCount` integer
  - `commentCount` integer
  - `taskTotal` integer
  - `gmailThreadCount` integer
  - `fileCount` integer
  - `boxKey` string
  - `key` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/streakyc/apis/directory-fields.md) · [All operations](https://skmtc.net/streakyc/apis/directory-fields/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streakyc/directory-fields/versions/f9ece0b33f19/schema)