Removing Subscriber

Use the del-member to remove a subscriber from specified mailing lists.

In this chapter:

Request Packet Structure

Response Packet Structure

Samples

 

Request Packet Structure

A request XML packet removing a subscriber from the specified mailing lists includes the del-member operation node:

<packet>
<maillist>
<del-member>
...  
</del-member>
</maillist>
</packet>

 

The add-member node is presented by the MaillistAddMemberInputType type (maillist.xsd), and its graphical representation is as follows:

Remarks

You can delete a subscriber from multiple mailing lists using different filtering rules in a single packet. Add as many del-member operations as the number of different filtering rules to be applied.

<del-member>
   ...
</del-member>
   ...
<del-member>
   ...
</del-member>

 

Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.

 

Response Packet Structure

The del-member node of the output XML packet is presented by type MaillistDelMemberOutputType (maillist.xsd) and structured as follows:

 

 

Samples

Removing a subscriber from a single mailing list

This request packet removes the subscriber with e-mail address mymail@mysite.com from mailing list MyMailer.

<packet>
<maillist>
<del-member>
   <filter>
      <list-name>MyMailer</list-name>
   </filter>
   <id>mymail@mysite.com</id>
</del-member>
</maillist>
</packet>

Response:

<packet>
<maillist>
<del-member>
   <result>
      <status>ok</status>
      <filter-id>MyMailer</filter-id>
      <id>mymail@mysite.com</id>
   </result>
</del-member>
</maillist>
</packet>

 

If the subscriber was not subscribed to MyMailer, the response looks as follows:

<packet>
<maillist>
<get-members>
   <result>
      <status>error</status>
      <errcode>1023</errcode>
      <errtext>Member is not subscribed to mailing list</errtext>
      <filter-id>MyMailer</filter-id>
   </result>
</get-members>
</maillist>
</packet> 
Removing a subscriber from multiple mailing lists

This request packet removes the subscriber with e-mail address mymail@mysite.com from mailing lists MyMailer and SubscribeMe.

<packet>
<maillist>
<del-member>
   <filter>
      <list-name>MyMailer</list-name>
      <list-name>SubscribeMe</list-name>
   </filter>
   <id>mymail@mysite.com</id>
</del-member>
</maillist>
</packet>

 

The positive response from the server looks as follows:

<packet>
<maillist>
<del-member>
   <result>
      <status>ok</status>
      <filter-id>MyMailer</filter-id>
      <id>mymail@mysite.com</id>
   </result>
   <result>
      <status>ok</status>
      <filter-id>SubscribeMe</filter-id>
      <id>mymail@mysite.com</id>
   </result>
</del-member>
</maillist>
</packet>