listUpdateMember – v1.1

 listUpdateMember(string apikey, string id, string email_address, array merge_vars, string email_type, boolean replace_interests)

Edit the email address, merge fields, and interest groups for a list member

Section
List Related

mcapi_listUpdateMember.php

Parameters
apikey	a valid API Key for your user account. Get by calling Get by visiting your API dashboard
id	the list id to connect to. Get by calling lists()
email_address	the current email address of the member to update
merge_vars	array of new field values to update the member with. See merge_vars in listSubscribe() for details.
email_type	change the email type preference for the member ("html" or "text"). Leave blank to keep the existing preference (optional)
replace_interests	flag to determine whether we replace the interest groups with the updated groups provided, or we add the provided groups to the member's interest groups (optional, defaults to true)

Returns
boolean	true on success, false on failure. When using MCAPI.class.php, the value can be tested and error messages pulled from the MCAPI object

Examples (1)

download example code

[1] mcapi_listUpdateMember.php

<?php
/**
This Example shows how to update a List Member's information using the MCAPI.php 
class and do some basic error checking.
**/
require_once 'inc/MCAPI.class.php';
require_once 'inc/config.inc.php'; //contains apikey
 
$api = new MCAPI($apikey);
 
$merge_vars = array("FNAME"=>'Richard', "LNAME"=>'Wright');
 
$retval = $api->listUpdateMember($listId, $my_email, $merge_vars, 'html', false);
 
if ($api->errorCode){
	echo "Unable to update member info!\n";
	echo "\tCode=".$api->errorCode."\n";
	echo "\tMsg=".$api->errorMessage."\n";
} else {    
	echo "Returned: ".$retval."\n";
}