Tools and News for Developers using the AllClients Platform

GetContactNotes

Overview

Get notes for a specified contact via an http form post.

Post Url

https://www.allclients.com/api/2/GetContactNotes.aspx
  • SSL is requred
  • White Label CRM Customers: Replace www.allclients.com with your White Label CRM domain name.

Important Note

Submitting a blank field will result in clearing the data for that field out of the database. If you don’t want to change a field, do not submit it with the form.

Note dates are in US Central Standard Time

notecontent is wrapped in a CDATA tag.  This allows special characters to reside in an XML document without hurting the integrity of the XML.

Form Fields

Field Max Length* Required Notes
response_type No Default results will be returned in XML.Set this field value to json to return results in JSON format
accountid Yes Must be numeric. Account ID for this account. Found in Settings > API Settings or for White Label CRM in the Admin control panel
apikey Yes API Key for this account. Found in Settings > API Settings or for White Label CRM in the Admin control panel
identifymethod 1 Yes Values:1 : By contactid (It’s recommended that you use this method and store our contactid in your system)

2 : By primary email on file. If there are multiple matches for the email address, we will choose the first one (by add date)

3: By email or other email on file.  If there are multiple matches for the email address, we will choose the first one (by add date)

identifyvalue 75 Yes Value changes based on indentifymethod. Must be integer if contactid, otherwise must be an email address on file

* An error will not result if Max Length is exceeded. Data will be trimmed to this length. 

Sample Results

Success Message

<?xml version="1.0"?>
<results>
    <notes>
        <note>
         <date>10/2/2014 3:22 PM</date>
         <notecontent><![CDATA[Called customer.  No answer.]]></notecontent>
       </note>
       <note>
         <date>10/8/2014 4:15 PM</date>
         <notecontent><![CDATA[Customer called and ordered 17 widgets.]]></notecontent>
    </note>
  </notes>
</results>

Sample Failure Message

<?xml version="1.0"?>
<results>
    <error>Authentication failed</error>
</results>


<?xml version="1.0"?>
<results>
    <error>Get Notes failed: Contact not found</error>
</results>