---
title: "Create Order Status"
method: POST
path: "/salesorderStatuses"
tags: ["Orders / Statuses"]
---

# Create Order Status

`POST /salesorderStatuses`

## Request

- Base URL: `https://api.forcemanager.com/api/v4`
- URL: `https://api.forcemanager.com/api/v4/salesorderStatuses`
- Auth: API key in header `X-Session-Key`

This endpoint allows you to create an Order Status based on JSON input.

You will only be able to create an Order Status after first providing the Session Key. To know how you can obtain the Session Key, [go to Authentication](#tag/authentication/POST/login).

**HEADERS**

| **Parameter** | **Value** | **Description** |
| --- | --- | --- |
| Content-Type | application/json | Language in which all request and response bodies are encoded |
| Accept | \*/\* | Any data of whatever mime type is accepted |
| X-Session-Key | AUTH_TOKEN | This field must be completed with the token obtained at the authentication |

**REQUEST BODY**

| **Attribute** | **Type** | **Description** |
| --- | --- | --- |
| branchVisibility | Object, Null | In which Branch the Order Status is visible |
| descriptionBR | String | Order Status label in Brasilian Portuguese |
| descriptionDE | String | Order Status label in German |
| descriptionDK | String | Order Status label in Dutch |
| descriptionEN (*Required*) | String | Order Status label in English |
| descriptionES | String | Order Status label in Spanish |
| descriptionFR | String | Order Status label in French |
| descriptionIT | String | Order Status label in Italian |
| descriptionPT | String | Order Status label in Portuguese |
| descriptionRU | String | Order Status label in Russian |
| descriptionUS | String | Order Status label in American English |
| won | Boolean | If true, the Order has been won |
| lost | Boolean | If true, the Order has been lost |
| order | Integer | he position of the Order Status in the Order Statuses value list |

**RESPONSE**

| **Attribute** | **Type** |
| --- | --- |
| Id | Id assigned to the new Order Status |
| Message | The operation status |

**RESPONSE CODES**

| **Status** | **Description** |
| --- | --- |
| 200 OK | Shows if operation succeeded |
| 400 Bad Request | Shows when an invalid request or the requested service is not available |

## Headers

- `Accept` string

## Request body

- object
  - `descriptionEN` string
  - `order` integer
  - `won` boolean
  - `lost` boolean

## Response `200`

Create Order Status

---

[API](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer.md) · [All operations](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/llms.txt) · [OpenAPI document](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/revisions/87db17204e2f?raw)