Create note - Thena AI

MCP tool: `create_note`

Creates a private note on any entity. Notes are automatically set to private visibility and are useful for internal documentation and team communication.

Example prompt

Create a note on ticket 71XNF90K10YBR86G1AN06KZJJFX40 with content "Customer requested urgent resolution"

Input parameters

Name	Type	Required	Description
entityType	string	Yes	The type of entity to add a note to (e.g., “ticket”, “accountActivity”, “note”, “task”)
entityId	string	Yes	The ID of the entity to add a note to
content	string	No	The plain text content of the note
attachmentIds	string[]	No	Array of attachment IDs to associate with the note
metadata	object	No	Any additional metadata (e.g., mentions, tags)

Response fields

Below are the fields you may see in the response:

Field	Type	Description
id	string	Note unique ID
content	string	Plain text content of the note
contentHtml	string	HTML formatted content
contentMarkdown	string	Markdown formatted content
contentJson	string	JSON formatted content for rich text
isEdited	boolean	Whether the note has been edited
threadName	string	Name of the comment thread
commentVisibility	string	Always “private”
commentType	string	Always “note”
isPinned	boolean	Whether the note is pinned
sourceEmailId	string	Email ID if note came from email
metadata	object	Additional metadata including mentions
createdAt	string (ISO8601)	Creation timestamp
updatedAt	string (ISO8601)	Last update timestamp
author	string	Author display name
authorAvatarUrl	string	Author’s avatar URL
attachments	array	Array of attachment IDs
authorId	string	Author’s user ID
authorUserType	string	Author’s user type (e.g., ORG_ADMIN)
impersonatedUserEmail	string	Email of impersonated user
impersonatedUserName	string	Name of impersonated user
impersonatedUserAvatar	string	Avatar of impersonated user
deletedAt	string	Deletion timestamp (null if not deleted)

Sample response

{
  "data": {
    "id": "PEDCR01K10RKS0142W6FR5AYJJMYJ",
    "content": "Internal note: Customer has been experiencing intermittent issues over the past month. Consider upgrading their account to premium support tier for better monitoring.",
    "contentHtml": "",
    "contentMarkdown": "Internal note: Customer has been experiencing intermittent issues over the past month. Consider upgrading their account to premium support tier for better monitoring.",
    "contentJson": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"attrs\":{\"textAlign\":\"left\"}}]}",
    "isEdited": false,
    "threadName": null,
    "commentVisibility": "private",
    "commentType": "note",
    "isPinned": false,
    "sourceEmailId": null,
    "metadata": {
      "mentions": []
    },
    "createdAt": "2025-07-25T12:19:31.410Z",
    "updatedAt": "2025-07-25T12:19:31.409Z",
    "author": "shakthi+1",
    "authorAvatarUrl": null,
    "attachments": [],
    "authorId": "UTH00SEXXFNVVN",
    "authorUserType": "ORG_ADMIN",
    "impersonatedUserEmail": null,
    "impersonatedUserName": null,
    "impersonatedUserAvatar": null,
    "deletedAt": null
  },
  "status": true,
  "message": "Comment created successfully!",
  "timestamp": "2025-07-25T12:19:31.442Z"
}