POST https://app.alaaqat.com/api/invoices/{invoice_id}/notes
Where invoice_id is the invoice's _id. Adds a note to the invoice. The note is written in the name of the team member who created the key. Your API key needs the invoice-note-create ability, and the team member needs Add Invoice Notes.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
description: string
}
| Field | Required | Validation | Description |
|---|---|---|---|
| description | Required | Text | The text of the note. |
{
"description": "The client will pay the remaining balance by bank transfer at the end of the month."
}
201 Created, with the new note under data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "The client will pay the remaining balance by bank transfer at the end of the month.",
"invoice_id": "6657c1d2e3f4a5b6c7d8e901",
"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. |