CreateContact()

Abstract

The CreateContact() API function is an XmlHttp function to create a new contact record based on the name and email address.  This will create a new contact record with the name and email provided and will automatically split the name fields.  Based on the domain of the email address passed (e.g. @domain.com), this function will also look to intelligently match this contact to their appropriate Client record based on the email address held against the Client record.

API Address

https://api.tracker-rms.com/WebAPI/XmlHttpCreateContact.aspx

Request Format

The input format XML for this function is as follows:

<?xml version="1.0"?>
<TrackerRMS>
    <UserLogon>
        <Username></Username>
        <Password></Password>
    </UserLogon>
    <ContactRecord>
        <Name></Name>
        <JobTitle></JobTitle>
        <Email></Email>
        <ClientName></ClientName>
        <BusinessPhone></BusinessPhone>
        <HomePhone></HomePhone>
        <MobilePhone></MobilePhone>
    </ContactRecord>
</TrackerRMS>
Parameter Notes
<Username> The username is typically the email address for the user in the format name@domain.com
<Password> The password will be the same as their web based password and can contain a combination of upper case, lower case and alpha-numeric characters
<Name> This is the name of the new Contact to create
<JobTitle> This is the Job Title for the Contact
<Email> This is the email address of the new Contact to create
<ClientName> This is the name of the Client which is used to match the Contact to a Client where possible
<BusinessPhone>, <HomePhone>, <MobilePhone> This is the telephone number of the new Contact to create

Response Format

The function will return a literal string value only containing the message to relay to the sender.

Example of a valid return:

Contact with email address ‘some.one@domain.com’ already exists in database, no action taken
User details cannot be verified
User ‘sender@domain.com’ not found
Contact (Firstname Surname) successfully created