# Order Comments Endpoint

#### Structure

<table border="1" id="bkmrk-name-type-descriptio" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col><col style="width: 25.0298%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td><td>**Required**  
</td></tr><tr><td>`id`</td><td>int</td><td>The id for the comment</td><td>No</td></tr><tr><td>`admin`</td><td>int|string</td><td>The id or email of the admin</td><td>No</td></tr><tr><td>`message`</td><td>string</td><td>The comment message</td><td>Yes</td></tr><tr><td>`customer_facing`</td><td>boolean</td><td>Whether the comment is customer facing (default: `false`)</td><td>No</td></tr><tr><td>`created_at`</td><td>timestamp</td><td>The date the comment was created (defaults to now)</td><td>No</td></tr></tbody></table>

<p class="callout info">If no admin is supplied then the API Token name will be displayed for the comment in the Admin.</p>

#### Example Request

```
POST /api/orders/{id|reference}/comments
```

```json
{
    "admin": "admin@example.com",
    "message": "This is an API message",
    "customer_facing": true,
    "created_at": "2025-09-01 09:29:41"
}
```

#### Example Response

```json
{
    "order": {
        "id": 1
    },
    "comment": {
        "id": 1
    }
}
```