Add a Note to a Product

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.

Header

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

Body

{
    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."
}

Response

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."
}

Errors

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.