Purpose

Appends a diary note to an existing claim. Returns the new note's ID. Notes are immutable — once written, they cannot be updated or deleted through the API.

Endpoint

Method: AddClaimNote
SOAPAction (1.1): "https://ftservices.onlinereportinginc.com/v2/AddClaimNote"
Parameter wrapper: <oNote>

Authentication

Standard credentials apply, supplied inside the <oNote> wrapper. See Authentication & Authorization.

Parameters

Name	Type	Required	Description
`Login`	string	yes	Authorized FileTrac system login.
`Password`	string	yes	Password for the login.
`CompanyKey`	string	yes	The unique company code provided by FileTrac.
`FileTracClaimID`	int	yes	System ID of the claim.
`Note`	string	yes	The note text. Limited to 4000 characters; longer text is truncated server-side.
`VisibleToClient`	boolean	no	Default `false`. When `true`, the note is flagged visible to the client company.
`NoteDateTimeStamp`	dateTime	no	Timestamp for the note. When omitted, the server uses its current datetime.
`NoteUserID`	int	no	System ID of the user who authored the note. When omitted, the authenticated login is used.
`NoteUserFirstName`	string	no	First name of the user who authored the note. Alternative to `NoteUserID`.
`NoteUserLastName`	string	no	Last name of the user who authored the note. Alternative to `NoteUserID`.

The Freshdesk narrative states the method accepts FileTracFileNumber as an alternative to FileTracClaimID. The WSDL envelope exposes only FileTracClaimID. Pass the claim ID.

Response

Returns a single int:

The new note's MessageID (NoteID) when successful.
0 if the note could not be inserted.

This method's response signature is bare-int, unlike AddClaimContact, UpdateClaimDates, and the payment methods, which return a {ID, ResponseMessage} complex result. The response message is not surfaced for this method.

Errors

Error Message	Cause	Remediation
`ERROR - Claim does not exist for that Adjusting Company`	`FileTracClaimID` does not identify a claim accessible to this login.	Confirm the claim ID via `GetClaimSummaries` or `GetClaimDetail`.
`ERROR inserting Note`	The note insert failed at the database layer.	Confirm note length is within the 4000-character limit; retry.

Because this method returns a bare int, these error strings would be surfaced through other channels (logs, SOAP fault on transport failure). In practice, integrators see 0 as the return value when the insert fails.

Remarks

Notes are immutable. There is no UpdateClaimNote or DeleteClaimNote. To correct a note, write a superseding note that references the original.
Note text is limited to 4000 characters. Truncate locally to avoid silent server-side truncation.
VisibleToClient cannot be changed after creation. Decide at write time.
NoteUserID vs name pair. Supply one or the other. When both are supplied, ID wins.
No retry-safe idempotency. Re-sending the same payload creates a duplicate note. Persist the returned MessageID after the first successful call.

Example Request (SOAP 1.1)

POST /v2/service.asmx HTTP/1.1
Host: ftservices.onlinereportinginc.com
Content-Type: text/xml; charset=utf-8
SOAPAction: "https://ftservices.onlinereportinginc.com/v2/AddClaimNote"<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddClaimNote xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oNote>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <FileTracClaimID>881204</FileTracClaimID>
        <Note>Contractor estimate received. Forwarding to underwriting for review before reserve adjustment.</Note>
        <VisibleToClient>true</VisibleToClient>
        <NoteDateTimeStamp>2026-05-27T11:30:00</NoteDateTimeStamp>
        <NoteUserID>3327</NoteUserID>
      </oNote>
    </AddClaimNote>
  </soap:Body>
</soap:Envelope>

Example Response (SOAP 1.1)

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <AddClaimNoteResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <AddClaimNoteResult>552110</AddClaimNoteResult>
    </AddClaimNoteResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

GetClaimNotes — verify the note appears in the claim's note list.
GetClaimDetail — returns the Notes list inline.
Note — the resulting type.