List Refresh Group

Method

To refresh a rule-based group, use the following syntax: 

<system>
    <system_name>list</system_name>
    <action>refresh_group</action>
    <sub_action/>
    <search_value>1234</search_value>
    <search_value2/>
</system>

Results

The successful completion of this script will return the <groupAsyncID> value, which you can use to check the status of this refresh with the Group Refresh Status Check command.

<?xml version="1.0" ?>
    <exacttarget>
        <system>
            <list>
                <groupRefresh>    
                    <groupID>363083</groupID>
                    <groupAsyncID>40594104</groupAsyncID>
                </groupRefresh>
            </list>
        </system>
    </exacttarget>

If the group ID you supplied belongs to a group based on random sampling or constant interval rather than on attribute rules, you'll receive the following result:

<?xml version="1.0" ?>
    <exacttarget>
        <system>
            <list>
                <error>101</error>
                <error_description>Error occurred during the group refresh event</error_description>
            </list>
        </system>
    </exacttarget>

If an error in your call occurs, the error code will be returned in XML format for the appropriate error trapping routine to be implemented.