---
title: "Create a pipeline"
method: PUT
path: "/pipelines"
---

# Create a pipeline

`PUT /pipelines`

## Request

- Base URL: `https://api.streak.com/api/v1`
- URL: `https://api.streak.com/api/v1/pipelines`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/docs/pipelines/put.ts> (a function with typed inputs; its response is checked against the schema)

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string, required: The name of the pipeline you are creating
  - `teamKey` string, required: The key of the team the pipeline will be shared with
  - `teamWide` boolean: Whether the pipeline will be shared with all users in the team
  - `fieldNames` string: The fields each box within the pipeline can have. Fields should be given as a comma-separated array of names and a comma-separated array of corresponding field types (of equal length). To modify after creation use the Field endpoint. Example: `["Sleepy", "Sneezy", "Doc"]`.
  - `fieldTypes` string: The type of the field. Can be any of: `TEXT_INPUT`, `DATE`, `TAG`, `FORMULA`, `DROPDOWN`, `CHECKBOX`, or `TEAM_CONTACT`. Should be an array of strings, ie `["TAG", "CHECKBOX", "DROPDOWN"]`.
  - `stageNames` string: The possible stages a box within a pipeline can be in, separated by comma. To modify after creation use the Stage endpoint. As an example, try `["Snow", "White"]`.

## Response `200`

200

- object
  - `creatorKey` string
  - `name` string
  - `teamWide` boolean
  - `fields` unknown[]
    - unknown
  - `stages` object
  - `stageOrder` unknown[]
    - unknown
  - `creationTimestamp` integer
  - `lastUpdatedTimestamp` integer
  - `aclEntries` unknown[]
    - unknown
  - `owner` object
    - `email` string
    - `isOwner` boolean
  - `pipelineKey` string
  - `key` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `467f4c2b40e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/changes/pipelines/put.md)

---

[API](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded.md) - [All operations](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/revisions/467f4c2b40e3?raw)