Purpose

Adds a contact (insured, claimant, attorney, expert, agent, contractor, witness, etc.) to an existing claim. Returns the new contact's ID and a response message.

Endpoint

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

Authentication

Standard credentials apply, supplied inside the <oContact> 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. Obtained from `AddClaim`, `GetClaimSummaries`, or `GetUpdatedClaims`.
`ContactType`	`ContactType`	yes	The type of contact. Use a value from `GetContactTypes` or from the enum.
`ContactIsPrimary`	boolean	no	When `true`, this contact becomes the primary contact of its type on the claim.
`ContactFirstName`	string	no	First name.
`ContactLastName`	string	no	Last name.
`ContactCompany`	string	no	Company affiliation.
`ContactCode`	string	no	Free-text contact code.
`ContactDescription`	string	no	Free-text description.
`ContactGender`	`ContactGender`	no	`Male` or `Female`.
`ContactOccupation`	string	no	Occupation.
`ContactHomePhone`	string	no	Home phone — maps to `Phone1` on the resulting `Contact`.
`ContactCellPhone`	string	no	Cell phone — maps to `Phone2`.
`ContactOfficePhone`	string	no	Office phone — maps to `Phone3`.
`ContactFax`	string	no	Fax.
`ContactEmail`	string	no	Email.
`ContactAddress1`	string	no	Address line 1.
`ContactAddress2`	string	no	Address line 2.
`ContactCity`	string	no	City.
`ContactState`	string	no	State. Must be the standard state/province abbreviation.
`ContactZip`	string	no	Postal code.
`ContactCountry`	string	no	Country.
`ContactNotes`	string	no	Free-text contact notes.

Response

Returns a complex AddClaimContactResult:

Field	Datatype	Description
`ContactID`	int	The new contact's ID when successful. `0` when the insert failed.
`ResponseMessage`	string	`Success` or a failure-identifying string.

Errors

This method does not produce documented error strings in Appendix I. Common failure modes:

Invalid FileTracClaimID — ContactID returns 0.
Invalid ContactType value — ContactID returns 0.
Authentication failure surfaces via ResponseCode per Error Codes & Response Codes.

Remarks

ContactType is required. If you don't know the valid values, call GetContactTypes first.
Setting ContactIsPrimary=true makes this the primary contact of its type. Any existing primary contact of the same type on this claim is demoted.
The Primary Insured and Primary Claimant are usually created by AddClaim through the InsuredFName/InsuredLName and ClaimantFName/ClaimantLName fields, not by this method. Use AddClaimContact for additional contacts that don't fit the insured/claimant slots.
There is no UpdateClaimContact method. To correct a contact, the only API path is to add a corrected contact and let the FileTrac UI clean up the obsolete one.

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/AddClaimContact"<?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>
    <AddClaimContact xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oContact>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <FileTracClaimID>881204</FileTracClaimID>
        <ContactType>Contractor</ContactType>
        <ContactIsPrimary>false</ContactIsPrimary>
        <ContactFirstName>Marco</ContactFirstName>
        <ContactLastName>Reyes</ContactLastName>
        <ContactCompany>Reyes Roofing</ContactCompany>
        <ContactOfficePhone>713-555-0188</ContactOfficePhone>
        <ContactEmail>mreyes@reyesroofing.example</ContactEmail>
        <ContactAddress1>3300 Yale Street</ContactAddress1>
        <ContactCity>Houston</ContactCity>
        <ContactState>TX</ContactState>
        <ContactZip>77018</ContactZip>
        <ContactCountry>USA</ContactCountry>
      </oContact>
    </AddClaimContact>
  </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>
    <AddClaimContactResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <AddClaimContactResult>
        <ContactID>442108</ContactID>
        <ResponseMessage>Success</ResponseMessage>
      </AddClaimContactResult>
    </AddClaimContactResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

GetContactTypes — call first to confirm valid ContactType values.
GetClaimDetail — verify the contact appears in the claim's Contacts list.
AddClaim — can create contacts as part of claim creation through the nested <Contacts> wrapper.
Contact — the resulting type.