---
title: "Create an opportunity status"
method: POST
path: "/status/opportunity/"
tags: ["opportunity_statuses"]
---

# Create an opportunity status

`POST /status/opportunity/`

Create a new opportunity status. The status must belong to a pipeline (specified by `pipeline_id`) and have a `type` of `active`, `won`, or `lost`.

## Query parameters

- `_fields` string

## Request body

- CreateOpportunityStatus
  - `label` string, required
  - `pipeline_id` string, nullable
  - `type` 'won' | 'lost' | 'active'

## Response `200`

Successful response

- OpportunityStatus
  - `id` string, required
  - `label` string, required
  - `organization_id` string, required
  - `pipeline_id` string
  - `type` 'won' | 'lost' | 'active', required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

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