---
title: "Add a note to a service ticket"
slug: "preview-create-a-service-ticket-note"
updated: 2026-02-10T13:22:27Z
published: 2026-02-10T13:22:27Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://www.bloxs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a service ticket note

Post/api/v1/maintenance/servicetickets/notes

Create a new service ticket note.

		
			

**Description**

Endpoint to add a note to an existing service ticket or to migrate the note history from another system into Bloxs. Each note must be submitted in a separate request. Alternatively, users can generate a PDF containing the note history and upload it as a single file using the [Add file to a service ticket API](/v1-api/apidocs/preview-add-file-to-a-service-ticket).

**Use Case**

Add a note to a service ticket.

**Request fields**

The request contains the following fields:

| Field | Description |
| --- | --- |
| reference | The unique identifier for this service ticket within Bloxs. This is unique (per client specific environment) for all service tickets. This identifier is generated by the Bloxs system. |
| externalIdentifier | The unique identifier within the system of the requesting party. This identifier is not generated by the Bloxs system. |
| message | The comment associated with the note, for example to indicate why the note was created or to provide additional context or clarification. |

		
		
SecurityHTTPType Bearer

Please enter a valid token

Body parameters<select class='api-response-data' aria-label='Media type'><option value='d0d0dfcc-0ac5-42f5-ad29-70d0eb692219'>application/json</option>
</select>object  referencestring   | null  
externalIdentifierstring   | null  
messagestring    RequiredMin length1

Responses200

The service ticket note was created

<select class='api-response-data' aria-label='Media type'><option value='f1f6dcc5-f27a-4e96-a52c-7684d2b3c2c7'>application/json</option>
</select>object  referencestring   | null  
externalIdentifierstring   | null  
messagestring    Min length1

400

The service ticket note data has validation issues

<select class='api-response-data' aria-label='Media type'><option value='0eff31eb-df44-451e-ab9a-7223241012e2'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring    

404

There was a problem creating the note for the service ticket

<select class='api-response-data' aria-label='Media type'><option value='017abfe2-3f3d-4622-8378-f0b8d5c55734'>application/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
traceIdstring   | null  
statusinteger  (int32)    
errorsobject | null  property* Array of string  | null  additionalPropertiesstring