WS_MailUpSend.GetListIdentity
DEPRECATED METHOD
The response of GetListIdentity method is different from many other MailUpSend methods because it includes "errorCode" only when call is not successful. If this inconsistency is critical for your client application you can use GetListIdentity_st method instead. GetListIdentity_st is the recommended choice if you are starting a new integration with MailUp.
Method parameters
GetListIdentity allows to retrieve the identifiers of a list in MailUp, starting from an external ID. When integrating with Microsoft Dynamics CRM, the identifier is ORGUNIQUENAME.
- string GetListIdentity(string accessKey, string autoId)
- accessKey: access key obtained using the LoginFromId method
- autoId: identifier which allows MailUp to know if a list was created in an automated context or not. In the Microsoft Dynamics CRM it corresponds to the ORGUNIQUENAME.
Sample GetListIdentity response
The method returns a string in XML format containing the list identifier and the GUID of the List created in the MailUp console.
<GetList> <Lists> <List Guid="Guid" Id ="X" Name="nome"/> </Lists> </GetList>
The XML string will have the following features:
- A root node <GetListIdentity>
- A node <Lists>, contained in the root node.
- A node <List> with the attributes Guid, Id e Name. These contain respectively the GUID of the list, the ID of the list and the name of the list provided at entrance,
In case of errors during the creation of the list, the XML will have the following structure:
<GetListIdentity> <Error>"Messaggio di errore"</Error> </GetListIdentity>
The XML string will have the following features:
- A root node <GetListIdentity>.
- A node <Error>, contained in the root node, returning the error message.