UpdateContact

Overview

Update a contact in the database via an http form post.

URL

POST/api/2/UpdateContact.aspx

Parameters

FieldMax LengthRequiredNotes
response_typefalseDefault response will be returned in XML.
Set this field value to json to return results in JSON format
accountidtrueMust be numeric. Account ID for this account.
Found in Settings > API Settings or for White Label CRM in the Admin control panel
apikeytrueAPI Key for this account.
Found in Settings > API Settings or for White Label CRM in the Admin control panel

Values:

1: By contactid (It's recommended that you use this method and store our contactid in your system)
identifymethod1true2: 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)
identifyvalue75trueValue of contactid or identifymethod
Must be integer if contactid, otherwise must be an email address on file
firstname50falseDatabase requires both first and last name
lastname50falseDatabase requires both first and last name
birthday10falseBirthday year is optional
Use only format YYYY/MM/DD or YYYY-MM-DD
Zero pad leading digits, so month digit 2 would be always 2 digits, January 5th is 01/05
otherfirstname50false
otherlastname50false
otherbirthday10falseBirthday year is optional
Use only format YYYY/MM/DD or YYYY-MM-DD
Zero pad leading digits, so month digit 2 would be always 2 digits, January 5th is 01/05
company50false
address50false
city50false
state20falseRecommended that this be the 2 digit state code for US addresses
postalcode20false
phone120falseWill automatically be formatted to (xxx) xxx-xxxx
phone1note20falseRecommended that description is used if known (work, home, mobile, etc...)
phone1textpossiblefalseUse value of "1" to set in Phone 1 for texting
phone220falseWill automatically be formatted to (xxx) xxx-xxxx
phone2note20false
phone2textpossiblefalseUse value of "1" to set in Phone 2 for texting
phone320falseWill automatically be formatted to (xxx) xxx-xxxx
phone3note20false
phone3textpossiblefalseUse value of "1" to set in Phone 3 for texting
phone420falseWill automatically be formatted to (xxx) xxx-xxxx
phone4note20false
phone4textpossiblefalseUse value of "1" to set in Phone 4 for texting
fax20falseWill automatically be formatted to (xxx) xxx-xxxx
email75false
webuser1false
...falseCustom 1 through 20
custom2050false
memo50falseBrief memo for contact. This is not a note, but a brief memo that shows up on the contact's page.
Recommended length: 100 characters
category50falseMust match the name of an existing Category exactly. Any mismatch will result in the category not being assigned.
category250falseMust match the name of an existing Category2 exactly. Any mismatch will result in the category2 not being assigned.
(This is the customizable contact)
source50falseMust match the name of an existing Source exactly. Any mismatch will result in the source not being assigned.
othersystemid32falseFor tracking the ID of this contact in another system
referredbyidfalseThe Contact ID of the referring contact.
Set to 0 (zero) to clear out the referral.
adddatefalseAlso include a time, since server time is US Central. Use format YYYY/MM/DD H:MM:SS. Should you run room for your time zone, otherwise the displayed date may not be at the proper local time zone.
Example: 1/30/2001 2:00PM
inactivefalseUse value of "1" to mark this contact as inactive
Use value of "0" to mark this contact as active