POST https://app.alaaqat.com/api/products/{product_id}/notes
Where product_id is the product's _id. Adds a note to the product. The note is written in the name of the team member who created the key. Your API key needs the product-note-create ability, and the team member needs Add Product Notes.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
description: string
}
| Field | Required | Validation | Description |
|---|---|---|---|
| description | Required | Text | The text of the note. |
{
"description": "The supplier raises the cost by 5% from January. Review the price before the new year."
}
201 Created, with the new note under data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "The supplier raises the cost by 5% from January. Review the price before the new year.",
"product_id": "6656b1c2d3e4f5a6b7c8d901",
"made_by": 12,
"updated_at": "2026-10-20T09:30:00.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"message": "Entity was created successfully."
}
| Status | Meaning |
|---|---|
| 402 | Your plan's limit of notes is reached. See the plans on the pricing page. |
| 422 | description is missing or isn't text. |