**Table of Contents**

### Overview

In order to add order note, you can do it by calling the endpoint described in this article.

In order to consume the endpoint, you must:

- Be an authenticated user

For information on how you can authenticate, see: [Authentication](https://developer.sellercloud.com/dev-article/authentication/)

As soon as you do authentication and receive a valid token, it needs to be passed on the call when retrieving order notes.

- Have a valid ID of an existing order

### Endpoint

Example for such endpoint for TT server is [https://tt.api.sellercloud.com/rest/api/orders/{orderID}/notes/](https://tt.api.sellercloud.com/rest/api/orders/%7BorderID%7D/notes/)

For your server, the endpoint will be:

[https://{your_server_id}.api.sellercloud.com/rest/api/orders/{orderID}/notes/](https://{your_server_id}.api.sellercloud.com/rest/api/orders/%7BorderID%7D/notes/)

### Request

- Method Type: **HttpPost**  
- Authorization: Use **Bearer Token** + token received from token authentication  
- Header info: **Content-Type: application/json**  
- Body data:

```
      {
          "OrderID": 13232,
          "note":
                 {
                     "Category": 0,
                     "Message": "test note message"
                 }
      }
```

|     |     |     |     |
| --- | --- | --- | --- |
| **Parameter** | **Data Type** | **Description** | **Is Required** |
| id | integer | ID of existing order. | yes |
| note | {<br>“Message”:”test_msg”<br>“Category”: 1<br>} | Message – message note<br>Category – specify if order note is General/0/,<br>Customer Instructions/1/,<br>or Customer Service Note/2/ | yes |

### Response

- If a server error appears, then the response will be with status code 500 => Internal Server Error  
- If adding a note is successful, the response will be in the following format:

### Note Types:

**General: 0**  
**Customer Instructions: 1**  
**Customer Service Note: 2**