Method Parameters
Removes a Group from a List.
Method Parameters
- string DeleteGroup(string accessKey, int listID, int groupID, bool deleteUsers)
- accessKey: access key obtained using the Login method
- listID: ID of the list that the Group belongs to
- groupID: ID of the Group
- deleteUsers: flag that determines whether the recipients assigned to the Group will be removed from the system
| Info |
|---|
| title | IMPORTANT: Removing Recipients |
|---|
|
| Note that there is a flag to indicate whether the recipients contained in the Group should also be removed from the system, or simply unassigned from that Group. Please check examples below. |
SOAP Examples
| Code Block |
|---|
| language | html/xml |
|---|
| title | SOAP Request with deleteUsers=false |
|---|
| linenumbers | true |
|---|
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://services.mailupnet. |
...
it/WS">
<soapenv:Header/>
<soapenv:Body>
<ws:DeleteGroup>
<ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9S8EyQZb6ZE2s</ws:accessKey>
<ws:listID>2</ws:listID>
<ws:groupID>23</ws:groupID>
<!-- if deleteUsers=false group is deleted but recipients remain subscribed to the specified list -->
<ws:deleteUsers>false</ws:deleteUsers>
</ws:DeleteGroup>
</soapenv:Body>
</soapenv:Envelope> |
| Code Block |
|---|
| language | html/xml |
|---|
| title | SOAP Request with deleteUsers=true |
|---|
| firstline | 1 |
|---|
| linenumbers | true |
|---|
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://services.mailupnet.it/WS">
<soapenv:Header/>
<soapenv:Body>
<ws:DeleteGroup>
<ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9S8EyQZb6ZE2s</ws:accessKey>
<ws:listID>2</ws:listID>
<ws:groupID>23</ws:groupID>
<!-- if deleteUsers=true then the group is deleted and the recipients that belong to this group are removed from specified list. If recipients of the group are also subscribed to other lists they remain subscribed to these lists, otherwise (i.e. if recipients are subscribed only to that list) they are completely removed from the system -->
<ws:deleteUsers>true</ws:deleteUsers>
</ws:DeleteGroup>
</soapenv:Body>
</soapenv:Envelope> |
| Code Block |
|---|
| language | html/xml |
|---|
| title | SOAP Response |
|---|
| firstline | 1 |
|---|
| linenumbers | true |
|---|
|
<DeleteGroupResult>
<errorCode>0</errorCode>
<errorDescription></errorDescription>
</DeleteGroupResult> |