POST https://app.alaaqat.com/api/companies/{company_id}/notes
Where company_id is the company's _id. Adds a note to the company. The note is written in the name of the team member who created the key. Your API key needs the company-note-create ability, and the team member needs Add Note to Company.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
description: string
}
| Field | Required | Validation | Description |
|---|---|---|---|
| description | Required | Text | The text of the note. |
{
"description": "Called to confirm the yearly renewal. Procurement asked for the updated price list."
}
201 Created, with the new note under data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "Called to confirm the yearly renewal. Procurement asked for the updated price list.",
"company_id": "6655a1b2c3d4e5f6a7b8c901",
"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. |