Refresh a Group

You can use SOAP API to reload subscribers into a group using the current subscriber data. This action is commonly performed prior to a send or other activity.

Refresh a group via the SOAP API using the execute method. Use these code examples to construct your own API calls.

.NET Code Example 

1ExecuteRequest request = new ExecuteRequest();
2request.Name = "RefreshGroup";
3request.Parameters = new APIProperty[1];
4request.Parameters[0] = new APIProperty();
5request.Parameters[0].Name = "ID";
6request.Parameters[0].Value = listID.ToString();
7status = proxy.Execute(ref requestKey, new ExecuteRequest[] { request }, out results);

SOAP Envelope Example 

1<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
2   <s:Header>
3      <a:Action s:mustUnderstand="1">Execute</a:Action>
4      <a:MessageID>urn:uuid:e34544b5-b951-44b0-9d56-2e8750d78b81</a:MessageID>
5      <a:ReplyTo>
6         <a:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
7      </a:ReplyTo>
8      <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
9      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
10         <o:UsernameToken u:Id="uuid-f3c9811c-42fd-44b2-8575-4561e0904070-1">
11            <o:Username>XXXXX</o:Username>
12            <o:Password>XXXXX</o:Password>
13         </o:UsernameToken>
14      </o:Security>
15   </s:Header>
16   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
17      <ExecuteRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
18         <Requests>
19            <Name>RefreshGroup</Name>
20            <Parameters>
21               <Name>ID</Name>
22               <Value>123456</Value>
23            </Parameters>
24         </Requests>
25      </ExecuteRequestMsg>
26   </s:Body>
27</s:Envelope>

Related Items