Salesforce Docs Portal

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

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

SOAP Envelope Example

<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">
   <s:Header>
      <a:Action s:mustUnderstand="1">Execute</a:Action>
      <a:MessageID>urn:uuid:e34544b5-b951-44b0-9d56-2e8750d78b81</a:MessageID>
      <a:ReplyTo>
         <a:Address>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
      </a:ReplyTo>
      <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
      <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <o:UsernameToken u:Id="uuid-f3c9811c-42fd-44b2-8575-4561e0904070-1">
            <o:Username>XXXXX</o:Username>
            <o:Password>XXXXX</o:Password>
         </o:UsernameToken>
      </o:Security>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <ExecuteRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
         <Requests>
            <Name>RefreshGroup</Name>
            <Parameters>
               <Name>ID</Name>
               <Value>123456</Value>
            </Parameters>
         </Requests>
      </ExecuteRequestMsg>
   </s:Body>
</s:Envelope>

Related Items