---
updatedAt: 2026-07-27T13:22:25.000Z
agentTools:
  projectIndex: https://developers.kommo.com/llms.txt
---

# Add notes

This method allows adding multiple notes

**Limitations**\
The method is available for all account users. The returned data depends on the user’s rights for the entity.

**Data type header when the request is successful**\
Content-Type: application/hal+json

**Data type header in case of an error**\
Content-Type: application/problem+json

## Response parameters

The method returns an array of note objects.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "kommo-api-references",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{subdomain}.kommo.com",
      "variables": {
        "subdomain": {
          "default": "subdomain"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/{entity_type}/notes": {
      "post": {
        "summary": "Add notes",
        "description": "This method allows adding multiple notes",
        "operationId": "add-notes",
        "parameters": [
          {
            "name": "entity_type",
            "in": "path",
            "description": "leads/contacts/companies",
            "schema": {
              "type": "string",
              "enum": [
                "leads",
                "contacts",
                "companies"
              ]
            },
            "required": true
          },
          {
            "name": "Content-Type",
            "in": "header",
            "description": "Request header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "RAW_BODY": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "entity_id": {
                          "type": "integer",
                          "description": "ID of the entity the note is added to",
                          "format": "int32"
                        },
                        "note_type": {
                          "type": "string",
                          "description": "Note type (https://developers.kommo.com/reference/notes-types)",
                          "enum": [
                            "common",
                            "call_in",
                            "call_out",
                            "service_message",
                            "geolocation",
                            "sms_in",
                            "sms_out",
                            "extended_service_message",
                            "attachment"
                          ]
                        },
                        "params": {
                          "type": "string",
                          "description": "Note properties depending on the note type (https://developers.kommo.com/reference/notes-types)",
                          "format": "json"
                        },
                        "request_id": {
                          "type": "string",
                          "description": "Field that will be returned unchanged in the response and will not be saved"
                        },
                        "is_need_to_trigger_digital_pipeline": {
                          "type": "boolean",
                          "description": "Defines whether to send events to the Digital Pipeline. An optional parameter. If it is not passed or passed with the value true, Digital Pipeline triggers will be processed, if false is passed, they will not. Affects such triggers: invoice paid, call completed and others that are launched when a note is added."
                        }
                      },
                      "required": [
                        "entity_id"
                      ],
                      "type": "object"
                    }
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": [
                    {
                      "entity_id": 1234567,
                      "note_type": "call_in",
                      "params": {
                        "uniq": "8f52d38a-5fb3-406d-93a3-a4832dc28f8b",
                        "duration": 60,
                        "source": "onlinePBX",
                        "link": "https://example.com",
                        "phone": "+14155551234"
                      }
                    },
                    {
                      "entity_id": 1234567,
                      "note_type": "call_out",
                      "params": {
                        "uniq": "8f52d38a-5fb3-406d-93a3-a4832dc28f8b",
                        "duration": 60,
                        "source": "onlinePBX",
                        "link": "https://example.com",
                        "phone": "+14155551234"
                      }
                    },
                    {
                      "entity_id": 1234567,
                      "note_type": "geolocation",
                      "params": {
                        "text": "Geo-tag note",
                        "address": "222 Columbus Ave Ste 407",
                        "longitude": "53.714816",
                        "latitude": "91.423146"
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Notes added successfully": {
                    "value": "{\n    \"_links\": {\n        \"self\": {\n            \"href\": \"http://example.kommo.com/api/v4/leads/notes\"\n        }\n    },\n    \"_embedded\": {\n        \"notes\": [\n            {\n                \"id\": 1234567,\n                \"entity_id\": XXXXXX,\n                \"request_id\": \"1\",\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://example.kommo.com/api/v4/leads/1234567/notes/XXXXXX\"\n                    }\n                }\n            },\n            {\n                \"id\": 7654321,\n                \"entity_id\": XXXXXX,\n                \"request_id\": \"2\",\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://example.kommo.com/api/v4/leads/7654321/notes/XXXXXX\"\n                    }\n                }\n            },\n            {\n                \"id\": 1231231,\n                \"entity_id\": XXXXXX,\n                \"request_id\": \"3\",\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://example.kommo.com/api/v4/leads/1231231/notes/XXXXXX\"\n                    }\n                }\n            }\n        ]\n    }\n}\n   "
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "text/plain": {
                "examples": {
                  "Invalid data given. Details are available in the response": {
                    "value": ""
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "User is not authorized": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "402": {
            "description": "402",
            "content": {
              "text/plain": {
                "examples": {
                  "Unpaid account": {
                    "value": ""
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "text/plain": {
                "examples": {
                  "Insufficient rights to call this method": {
                    "value": ""
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```