> For the complete documentation index, see [llms.txt](https://developers.alephee.com/v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.alephee.com/v2/orders/post-methods/create-a-new-order/request.md).

# Request and Response

Create a new order for a given account

<mark style="color:green;">`POST`</mark> `https://api.alephcrm.com/v2/orders`

#### Query Parameters

| Name                                         | Type                  | Description    |
| -------------------------------------------- | --------------------- | -------------- |
| API\_KEY<mark style="color:red;">\*</mark>   | String                | (default=none) |
| accountId <mark style="color:red;">\*</mark> | Integer               | (default=none) |
| orderInfo                                    | JSON-formatted string | (default=none) |

{% tabs %}
{% tab title="201: Created " %}

```json
[
  {
    "Message": "A number with the internal AlephCRM ID of the created order-for informational purposes only",
    "Level": {
      "Id": 99,
      "Name": "OK"
    }
  }
]
```

{% endtab %}

{% tab title="400: Bad Request " %}

```json
[
  {
    "Message": "Error string",
    "Level": {
      "Id": 0,
      "Name": "Error"
    }
  }
]
```

{% endtab %}

{% tab title="401: Unauthorized " %}

```json
[
  {
    "Message": "Error string",
    "Level": {
      "Id": 0,
      "Name": "Error"
    }
  }
]
```

{% endtab %}

{% tab title="403: Forbidden " %}

```json
[
  {
    "Message": "Error string",
    "Level": {
      "Id": 0,
      "Name": "Error"
    }
  }
]
```

{% endtab %}

{% tab title="412: Precondition Failed " %}

```json
[
  {
    "Message": "Error string",
    "Level": {
      "Id": 0,
      "Name": "Error"
    }
  }
]
```

{% endtab %}

{% tab title="416: Range Not Satisfiable " %}

```json
[
  {
    "Message": "Error string",
    "Level": {
      "Id": 0,
      "Name": "Error"
    }
  }
]
```

{% endtab %}

{% tab title="429: Too Many Requests {"Status": integer, "Message": string}" %}

{% endtab %}

{% tab title="500: Internal Server Error string" %}

{% endtab %}
{% endtabs %}

## Parameters details

### API\_KEY

The API\_KEY that was provided.

### accountId

The Alephee account ID of the shipping label you are trying to get.

### orderInfo

JSON package with the order to be created.