API Integration Security
Tenant-Specific API Endpoints
SOAP API Performance
Work with SOAP Web Service API
Supported Operations for Objects and Methods
Refresh a Group
API Call Volume History and Health
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.
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);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>