listUpdateMember()

Email or merge fields of this email is updated. Appropriate entry of recipient can be found both by e-mail and merge fields.

listUpdateMember(string $id, string $email_address, array $merge_vars, string $email_type) : boolean
Only active contacts can be updated. This function will not work on inactive or already unsubscribed recipients.
Input parameters
  • id - list ID
  • email_address - email address or ID (can be found by listMemberInfo function, see Obtaining additional email information)
  • merge_vars - merge fields (array)
  • Merge fields are: FNAME, LNAME, EMAIL and other your defined fields. 
  • email_type - type of email (HMTL, plain) (optional). Default value is empty string.
Information obtained
  • true if request for updating email or merge field has succeeded

Examples

mgapi_listUpdateMember.php
 'Richard', "LNAME" => 'Wright');
$email_type = 'html';
 
$retval = $api->listUpdateMember($id, $email_address, $merge_vars, $email_type);
 
header("Content-Type: text/plain");
if ($api->errorCode) {
    echo "Unable to load listUpdateMember()!\n";
    echo "\tCode=" . $api->errorCode . "\n";
    echo "\tMsg=" . $api->errorMessage . "\n";
} else {
    echo "Returned: " . $retval . "\n";
}
xml-rpc_listUpdateMember.php
 new xmlrpcval($apikey),
            'id' => new xmlrpcval($listId),
            'email_address' => new xmlrpcval($my_email),
            'merge_vars' => php_xmlrpc_encode(
                    array("FNAME" => 'Richard', "LNAME" => 'Wright')
            ),
            'email_type' => new xmlrpcval('html')
                ),
                'struct');
$f = new xmlrpcmsg('listUpdateMember', array($v));
$c = new xmlrpc_client($apiUrl["path"], $apiUrl['host'], 80);
$c->setDebug($debug);
$r = &$c->send($f);
 
header("Content-Type: text/plain");
if (!$r->faultCode()) {
    $retval = php_xmlrpc_decode($r->value());
    echo "Returned: " . $retval . "\n";
} else {
    echo "Unable to load listUpdateMember()!\n";
    echo "\tCode=" . $r->faultCode() . "\n";
    echo "\tMsg=" . $r->faultString() . "\n";
}
mgapi_listUpdateMember.py
from lib.config import * #contains apikey
from lib.MGAPI import MGAPI
 
# This Example shows how to ping using the MGAPI.php class and do some basic error checking.
 
api = MGAPI(apikey)
 
id = listId
email_address = my_email
merge_vars = {"FNAME": 'Richard', "LNAME": 'Wright'}
email_type = 'html'
 
retval = api.listUpdateMember(id, email_address, merge_vars, email_type)
if api.errorCode:
    print "Unable to load listUpdateMember()!"
    print "\tCode=", api.errorCode
    print "\tMsg=", api.errorMessage
else:
    print "Returned: ", retval

© 2010-2017 Mailigen. All rights reserved.