ADDEDIT Contact API Version 1 (DEPRECATED)

Ron Torres

Modified on: Thu, 19 Nov, 2015 at 11:51 AM

ADDEDIT Contact API Version 1

Updated on 2014-04-28
Current Version: Version 1
Deprecated Version: NA
Requests Allowed: GET&SOAP

Summary:

Returns "Contact {first_name} {last_name} Created" or "Contact {first_name} {last_name} Updated"

Resource/WSDL Page:

http://<your_domain_here>/api/1/addedit.asmx?op=Contact

Parameters

api_key Required Type: STRING Length (Max/Min): 50	Must be a valid API Key (existing and NOT expired) Example Values: Fo35NRAqvFLXoZxqB4aViaiYM7iVMhh
entity_type Required Type: ENTITYTYPES Length (Max/Min): NA	Required affiliate, advertiser, buyer, list_manager Example Values:
entity_id Required Type: INT Length (Max/Min): NA	Entities ID [affiliate ID / advertiser ID / buyer ID / list_manager ID] Example Values: 123456
contact_id Required Type: INT Length (Max/Min): NA	Contact ID ["0" New Contact / Contact ID Update Contact] 0 to create, > 0 to edit Example Values: 0
include_in_mass_email Required Type: BOOL Length (Max/Min): NA	Allow Contact to Receive System Emails? ["TRUE", "FALSE"] Example Values: True
contact_first_name Required Type: STRING Length (Max/Min): 25	Contact's First Name Example Values: FirstName
contact_middle_name Required Type: STRING Length (Max/Min): 25	Contact's Middle Name Example Values: MiddleName
contact_last_name Required Type: STRING Length (Max/Min): 25	Contact's Last Name Example Values: LastName
contact_email_address Required Type: STRING Length (Max/Min): 60	Contact's email address Example Values: contact@email.com
contact_password Required Type: STRING Length (Max/Min): 25	Contact's password Example Values: Password
contact_title Required Type: STRING Length (Max/Min): 30	Contact's Title Example Values: Director
contact_department_id Required Type: BYTE Length (Max/Min): NA	Department Contact is From ["0" ignore field]{See get.asmx > Departments} Example Values: 0
contact_phone_work Required Type: STRING length (Max/Min): 30	Contact's Work Phone Number Example Values: 949-548-2253
contact_phone_cell Required Type: STRING Length (Max/Min): 30	Contact's Cell Phone Number Example Values: 555-867-5309
contact_phone_fax Required Type: STRING Length (Max/Min): 30	Contact's Fax Phone Number Example Values: 123-456-7890
contact_im_service Required Type: STRING Length (Max/Min): 30	Contact IM Service ["0" = AIM, "1" = Google, "2" = MSN, "3" = Skype, "4" = Yahoo, "-1"= Ignore IM Contact Service] Example Values: 1
contact_im_name Required Type: STRING Length (Max/Min): 50	Contact's IM Name Example Values: ContactName
contact_timezone Required Type: STRING length (Max/Min): 4	Contact's Timezone Example Values: PST
contact_language_id Required Type: BYTE Length (Max/Min): NA	Contact Language ID {See get.asmx > Languages} 0 sets it to NULL Example Values: 0

**Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value).

Example Request

GET

http://demo.cakemarketing.com/api/1/addedit.asmx/Contact?api_key=dNJFmId9rI&entity_type=affiliate&entity_id=1&contact_id=0&include_in_mass_emails=FALSE&contact_first_name=First&contact_middle_name=Middle%20Name&contact_last_name=Last&contact_email_address=eamil@getcake.com&contact_password=h@ck3r&contact_title=QA%20Engineer&contact_department_id=0&contact_phone_work=9495482253&contact_phone_cell=9492761052&contact_phone_fax=&contact_im_service=0&contact_im_name=myAIMaccount&contact_timezone=PST&contact_language_id=1

Sample XML Response:

<contact_addedit_response>
<success>true</success>
<message>Contact First Last Created</message>
<contact_id>3590</contact_id>
</contact_addedit_response>

Example Error Messages:

Error Message	Likely Cause
Invalid API Key	API Key does not exist or is expired
Invalid Entity Type	entity_type does not equal a valid entity type
Invalid Entity ID	entity_id does not match a valid entity for the specified entity type
Invalid Contact First Name	contact_first_name is NULL or empty or exceeds 25 characters
Invalid Contact Middle Name	contact_middle_name exceeds 25 characters
Invalid Contact Last Name	contact_last_name is NULL or empty or exceeds 25 characters
Invalid Contact Email Address	contact_email_address is NULL or empty or exceeds 60 characters
Invalid Contact Password	contact_password exceeds 25 characters
Invalid Contact Title	contact_title exceeds 30 characters
Invalid Contact Phone Work	contact_phone_work exceeds 30 characters
Invalid Contact Phone Cell	contact_phone_cell exceeds 30 characters
Invalid Contact Fax	cpmtact_phone_fax exceeds 30 characters
Invalid Contact IM Service	contact_im_service exceeds 30 characters
Invalid Contact IM Name	contact_im_name exceeds 50 characters
Invalid Contact Time Zone	contact_timezone exceeds 4 characters
Invalid Contact Language	contact_language_id does not correspond to a supported language
Invalid Contact Department	contact_department_id does not correspond to a department
Invalid Email Address	contact_email_address is not valid
Invalid Contact ID	contact_id does not correspond to a contact in the system