# Add Note To Contact History

Adds a permanent internal note to a contact’s history. The contact never sees it; it does not start automations. Notes cannot be edited or removed.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "contactId": {
      "type": "integer",
      "description": "Numeric contact ID returned by search-contacts",
      "minimum": 1
    },
    "text": {
      "type": "string",
      "description": "The note as plain text; line breaks are kept",
      "minLength": 1,
      "maxLength": 5000
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "contactId",
    "text"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "contactId",
    "historyEntryId",
    "date",
    "text",
    "historyUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "contactId": {
      "type": "integer"
    },
    "historyEntryId": {
      "type": "integer"
    },
    "date": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "historyUrl": {
      "type": "string"
    }
  }
}
```