updateRecipient

Update the recipients information in Examinare database.

POST data information:

(Red information is mandatory, black is optional), all POST data captions are case-sensitive.

contactID Contact ID from your Examinare database.
name First name of the recipient.
lastname Last name of the recipient.
email Email of the recipient.
mobile Cell-phone number. (Format 00[Countrycode][Area code][Phone number])Example : +467031234567
group Group name.
title Personal title.
company Company name.
company-title Company title of the recipient.
department Department in Company.
customer-group Customer group.
gender Gender of the recipient. (male for Male, female for Female).
birth-year Year of birth (YYYY), digits only.
birth-month Month of birth (MM), digits only.
birth-day Day of birth (DD), digits only.
phonenumber Phone number of the recipient.
attention Attention address of the recipient.
address Address of the recipient.
city City name.
state State name.
postal-code Postal code.
country Country name.
extrafieldkey Key from extrafields in the format explained here.

Return data

This API call will return a XML response with status Success if it is updated, error if an error has been called. The XML contacts container will contain the information including the contactID that will be used in your calls to the framework. (See addRecipient)

Please note that example below is for addrecipient and needs to be adjusted to use the update function.

XML-Return

<?xml version="1.0" encoding="utf-8"?>
 <response> 
 <status>Status</status>
 <contacts> 
 <contact cid="contactID">
    <contactID>829128191289</contactID>
      	<authCode>829108</authCode>
		<name>Name</name>
		<lastname>Last name</lastname>
		<email>info@domain.com</email>
		<mobile>+467031234567</mobile>
		<group>Groupname</group>
		<title>Mr</title>
		<company>Company name</company>
		<company-title>Company name</company-title>
		<department>Sales</department>
		<customer-group>Sales groups</customer-group>
		<gender>male</gender>
		<birth-year>1919</birth-year>
		<birth-month>1919</birth-month>
		<birth-day>1919</birth-day>
		<phonenumber>+46844444444</ phonenumber>
		<attention>Attention</attention>
		<address>Adress</address>
		<city>Kristianstad</city>
		<postal-code>29184</postal-code>
		<state>Skane</state>
		<country>Sweden</country>
		<crmserial>15001</crmserial>		
		<extrafields>
			<extrafield>
				<key>f54601af5d3377</key>
				<value>Testar åäö</value>
			</extrafield>
			<extrafield>
				<key>f5461293d9b22d</key>
				<value></value>
			</extrafield>
			<extrafield>
				<key>f5460eb07e2f93</key>
				<value>7</value>
			</extrafield>
		</extrafields>
	</contact>
</contacts>
</response>

PHP Example (With our PHP Wrapper Library.
<?php 						
	include_once("examinare-api.php");
	$key["apicompany"]="XXXX";						
	$key["apikey"]="YYYYYY";	
							
	/* Change the top information 
	according to your account details. */
						
	$api2 = new ExaminareAPIConnector($key["apicompany"],$key["apikey"],"");
	$api2->setCommand("addRecipient");
	$recipient_r = Array();
                        
	$recipient_r["name"]="My name";
	$recipient_r["email"]="myname@mydomain.com";
	$recipient_r["group"]="My Group";
                        
	$api2->Data($recipient_r);
						
	$result=$api2->Execute();
						
                        
	/* In $result you will now find all 
	returnable errors if any or the Recipient record to use.*/
                        
?>                       

We are just a phone-call away(or an email/chat).

Contact us by email, phone or chat.
Contact Examinare Support