« Back to Documentation Overview

listMergeVarAdd – v1.1

 listMergeVarAdd(string apikey, string id, string tag, string name, boolean req)

Add a new merge tag to a given list

Section
List Related
xml-rpc_listMergeVarAdd.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()
tag The merge tag to add, e.g. FNAME
name The long description of the tag being added, used for user displays
req optional - Whether or not to require this field to be filled in, defaults to false
Returns
bool true if the request succeeds, otherwise an error will be thrown

Examples (1)

download example code

[1] xml-rpc_listMergeVarAdd.php

  1. <?php
  2. /**
  3. This Example shows how to add an Merge Variable to a list using XML-RPC.
  4. Note that we are using the PEAR XML-RPC client and recommend others do as well.
  5. **/
  6. require_once 'XML/RPC2/Client.php';
  7. require_once 'inc/config.inc.php';
  8. try {
  9. $client = XML_RPC2_Client::create($apiUrl);
  10.  
  11. $result = $client->listMergeVarAdd($apikey, $listId, 'TEST','Testing', false);
  12. echo "SUCCESS! \n";
  13. echo "Returned: $result\n";
  14. } catch (XML_RPC2_FaultException $e){
  15. echo "ERROR!!!!\n";
  16. echo $e->getFaultCode()." : ".$e->getFaultString()."\n";
  17. }
  18.  
  19.