This method changes the parent list or name of an existing list.
Syntax
LM_AlterListID(ListID, ParentListID, ListName, LicenseKey)
Request Parameters
| Parameter Name | Description | Data Type | Required | Sample Value | 
|---|---|---|---|---|
| ListID | The list’s ID. | Integer | True | 1234 | 
| ParentListID | The ID of a list which will be this list’s parent. If you don’t want your list to have a parent, set this value to 0. To leave the parent list setting unchanged, set this value to-1. | Integer | True | 1230 | 
| ListName | The name you want to apply to the list. | String | True | List Three | 
| LicenseKey | Your license key. | String | True | 00000000-0000-0000-0000-000000000000 | 
Response
Returns: Boolean
Description: True if the alteration succeeded. False otherwise.
Code Samples
You can use any programming language you want with our API, as long as it can make a REST or SOAP call. Here are examples for some of the most common platforms.
- C#
- Java
- Python
- GET Request
- POST Request
- SOAP 1.1 Request
- SOAP 1.1 Response
- SOAP 1.2 Request
- SOAP 1.2 Response
- XML Response
C#
/* https://ws.esendex.us/notifyws/phonenotify.asmx?wsdl was added as a Service Reference and given the name WSDL */
using WSDL;
var client = new PhoneNotifySoapClient(PhoneNotifySoapClient.EndpointConfiguration.PhoneNotifySoap);
var listId = 1234;
var parentListId = -1;
var listName = "My List";
var altered = await client.LM_AlterListIDAsync(
    listId, parentListId, listName, YOUR_LICENSE_KEY);
Console.WriteLine("List was altered: " + altered);
Java
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
public final class LM_AlterListID {
    public static void main(String[] args) throws Exception {
        try {
            URL url = new URL("https://ws.esendex.us/NotifyWS/PhoneNotify.asmx/LM_AlterListID?" + "&ListID=00000"
                            + "&ParentListID=0" + "&ListName=Customer+List"
                            + "&licensekey=00000000-0000-0000-0000-000000000000");
            try {
                InputStream in = url.openStream();
                StreamSource source = new StreamSource(in);
                printResult(source);
            } catch (java.io.IOException e) {
                e.printStackTrace();
            }
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }
    }
    private static void printResult(Source source) {
        try {
            ByteArrayOutputStream bos = new ByteArrayOutputStream();
            StreamResult sr = new StreamResult(bos);
            Transformer trans = TransformerFactory.newInstance().newTransformer();
            Properties oprops = new Properties();
            oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
            trans.setOutputProperties(oprops);
            trans.transform(source, sr);
            System.out.println("**** Response ******");
            System.out.println(bos.toString());
            bos.close();
            System.out.println();
        } catch (Exception e) {
        }
    }
}
Python
import zeep
client = zeep.Client(wsdl="https://ws.esendex.us/notifyws/phonenotify.asmx?wsdl")
list_id = 1234
parent_list_id = 0
list_name = "My Awesome List"
license_key = "00000000-0000-0000-0000-000000000000"
result = client.service.LM_AlterListID(list_id, parent_list_id, list_name, license_key)
print(result)
GET Request
GET /NotifyWS/PhoneNotify.asmx/LM_AlterListID?ListID=string&ParentListID=string&ListName=string&Licensekey=string HTTP/1.1
Host: ws.esendex.usPOST Request
POST /NotifyWS/PhoneNotify.asmx/LM_AlterListID HTTP/1.1
Host: ws.esendex.us
Content-Type: application/x-www-form-urlencoded
Content-Length: length
ListID=string&ParentListID=string&ListName=string&Licensekey=stringSOAP 1.1 Request
POST /NotifyWS/PhoneNotify.asmx HTTP/1.1
Host: ws.esendex.us
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://ws.esendex.us/NotifyWS/LM_AlterListID"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <LM_AlterListID xmlns="https://ws.esendex.us/NotifyWS/">
      <ListID>int</ListID>
      <ParentListID>int</ParentListID>
      <ListName>string</ListName>
      <Licensekey>string</Licensekey>
    </LM_AlterListID>
  </soap:Body>
</soap:Envelope>SOAP 1.1 Response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <LM_AlterListIDResponse xmlns="https://ws.esendex.us/NotifyWS/">
      <LM_AlterListIDResult>boolean</LM_AlterListIDResult>
    </LM_AlterListIDResponse>
  </soap:Body>
</soap:Envelope>SOAP 1.2 Request
POST /NotifyWS/PhoneNotify.asmx HTTP/1.1
Host: ws.esendex.us
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LM_AlterListID xmlns="https://ws.esendex.us/NotifyWS/">
      <ListID>int</ListID>
      <ParentListID>int</ParentListID>
      <ListName>string</ListName>
      <Licensekey>string</Licensekey>
    </LM_AlterListID>
  </soap12:Body>
</soap12:Envelope>SOAP 1.2 Response
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LM_AlterListIDResponse xmlns="https://ws.esendex.us/NotifyWS/">
      <LM_AlterListIDResult>boolean</LM_AlterListIDResult>
    </LM_AlterListIDResponse>
  </soap12:Body>
</soap12:Envelope>XML Response
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="https://ws.esendex.us/NotifyWS/">boolean</boolean>HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="https://ws.esendex.us/NotifyWS/">boolean</boolean>HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="https://ws.esendex.us/NotifyWS/">boolean</boolean>HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="https://ws.esendex.us/NotifyWS/">boolean</boolean>HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<boolean xmlns="https://ws.esendex.us/NotifyWS/">boolean</boolean>