Skip to main content
POST
Creates a new internal-note event in a conversation without sending a customer-facing message or generating an AI response. Native ticketing must be enabled for the workspace, and the conversation must have a widget or email source. Unlike Add feedback note, this endpoint creates a new event rather than annotating an existing response. It does not post a note to an external helpdesk.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_.... The key needs write scope.
string
required
Send application/json.

Path parameters

string
required
ID of a widget or email conversation in the authenticated workspace.

Body parameters

string
required
Note text. Leading and trailing whitespace is trimmed; the result must not be empty. This endpoint accepts text, not attachments.

Response

Returns 201 Created with a single public event object, not an array or a success wrapper.
string
ID of the newly created event.
string
Conversation ID supplied in the path.
number
Event creation time as a Unix timestamp in milliseconds.
string
agent for the internal note.
string
internalnote.
string
The trimmed note text supplied as content.
The event also includes the standard public-event feedback, external-reference, attachment, tag, and article fields. The empty arrays in this example are intentional: a newly created text note has no attachments, tags, or retrieved articles. Private author metadata is not included in this public response.

Errors

content is missing, is not a string, or is empty after trimming; or the conversation source is not widget or email.
The workspace API key is missing or invalid.
The API key lacks write scope, or native ticketing is not enabled for the workspace.
The conversation cannot be accessed in the authenticated workspace.