Last fall, Alex explained how to Clear Contacts From Lists in v3 of the API. You now have the same ability in v4 API using the clearLists function. All you need to do is specify the list id returned from the addLists or readLists function. After you call clearLists, all your contacts will be removed from the list, however, they will remain in Bronto.

Here is a sample SOAP message that would clear two lists.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v4="http://api.bronto.com/v4">
   <soapenv:Header>
      <v4:sessionHeader>
         <sessionId>b058d5e0-7cb4-4578-b16f-a4c049079207</sessionId>
      </v4:sessionHeader>
   </soapenv:Header>
   <soapenv:Body>
      <v4:clearLists>
         <list>
            <id>0bbb03ec0000000000000000000000038e93</id>
         </list>
         <list>
            <id>0bbb03ec00000000000000000000000390d0</id>
        </list>
      </v4:clearLists>
   </soapenv:Body>
</soapenv:Envelope>

This PHP script would create a SOAP message like this.

<?php
/**
 * This example will clear two lists of all contacts on those lists.
 * You must edit the code to refer to the list id you wish to clear.
 */

$client = new SoapClient('https://api.bronto.com/v4?wsdl', array('trace' => 1, 'features' => SOAP_SINGLE_ELEMENT_ARRAYS));
setlocale(LC_ALL, 'en_US');

try {
        $token = "#####API TOKEN###########";

        print "logging in<br>";
        $sessionId = $client->login(array('apiToken' => $token))->return;

        $session_header = new SoapHeader("http://api.bronto.com/v4",
                           'sessionHeader', array('sessionId' => $sessionId));
        $client->__setSoapHeaders(array($session_header));

        $ids = array(array('id' => '0bbb03ec0000000000000000000000038e93'),
                   array('id' => '0bbb03ec00000000000000000000000390d0'));

        $res = $client->clearLists($ids)->return;

        if ($res->errors) {
                print "There was a problem clearing your lists:<br>";
                print $res->results[$res->errors[0]]->errorString . "<br>";
        } else {
                print "Lists have been cleared<br>";
        }
} catch (Exception $e) {
        print "uncaught exception\n";
        print_r($e);
}
?>

Now you are able to quickly and easily clear your lists without having to find everyone on the list. We do suggest you exercise caution when using this function, as there is no rewind button. I hope you find this new functionality useful. Let us know if you have any questions.

Andrew Kanes
Support Engineer at Bronto

Related posts:

1. Spring Cleaning: Clearing Contacts From Lists This post only applies to Legacy Version 3 of the...
2. The Pluses And Minuses Of List Management What happened to all my lists?!?!? You might be asking...
3. Create a Header Without Logging into Bronto Did you know you can now create headers and footers...

As technology advances, so to do your needs for immediate results. As a user of the world wide web, you have become conditioned to expect your news and social status in real time. We have taken this into consideration and have implemented instant chat as a support option in the Bronto application. We are now available from 8am to 8pm EDT to answer any quick questions you may have right in your browser.

Where Do You Start

For example, if you are working in the application and have a question concerning navigation, just click the live chat link in the top right hand corner of almost any page. 

The Live Chat box will pop up in it’s own browser window. The application will ask you for a couple of pieces of information. Please enter your name, email address and a short description of your issue. Make sure these fields are accurately entered and click the “Start Chat” button.

Start Chatting

You should now be connected to a representative in the Client Services section. You can pose your full question to them and they can assist you with your issue. In the example below, Lucas instructs me on where to upload the images that I wish to use in my message.

Let’s Keep It Simple

Please remember we are emphasizing that this chat function is for quick on the go questions. If you have a more in depth issue or a question concerning the API, we suggest that you open a support case from the support link in the top right corner of any page in Bronto. This will assure you priority and a way to track the progress of your issue. If you have any questions on this new feature, please do not hesitate to contact Bronto Client Services.

Frank Chapman
Bronto Client Services

Related posts:

1. Advanced Webform Usage As a follow up to the blog post on Creating...
2. The Business of Exportation As you work in Bronto, a need may arise for...
3. Get Ready: The Bronto Fall 2009 Release You may have noticed Halloween displays at the local...

In Bronto, we have a link where you can go to preview the new webforms and start to get a feel for how they work. To access this link, jump into the current webforms area of your account and click on .

On the following screen, click Take Me To New Webforms. You should now see our new webforms area. This screen will look very similar to the previous webforms area with a list of the webforms you can edit, as well as the option to create some additional forms. Let’s take a look at how a contact add webform is created.

As you can see, it now looks very different. However, the new webforms area is designed to be much easier to use, with a more intuitive interface. Each section is now a drag and drop area, so when you create your webform, you will move the elements you want to your webform, and drop them where they need to go. In the left column, you will have the choice of moving rows with 1, 2, or 3 columns into the work area. Below the row selection, you can drag and drop your Fields, Lists, or any Text & HTML you want to be a part of your webform. At the top of the work area, there are some elements you will be required to add, such as the email address field, the submit button, and some optional elements like an email verify field or the Text/HTML preference option checkbox. Below is a screen shot showing the elements you can drag over to the webform work area.

In the next screen shot, I have dragged a row with two columns and added in the require email address field, submit button, and the fields First Name, Last Name, and City. The Email Address and Submit button are located in one column, and the fields are located in the second column.

Once you have added the elements to your webforms and set them up where they are going to be located, click the button to save your webform changes.

As you build your webform, you can also preview the layout by clicking the button located in the upper corner of the webforms page.

More elements of the new webforms will be available in the near future, but hopefully this gives you a quick insight into the way the new webforms are created. I invite you to spend some time trying out and testing some of the new webforms functionality, and please feel free to leave comments on what you think.

Rob Slade
Client Support Specialist
Bronto Software.

Related posts:

1. Getting Comfortable With New Webforms Bronto’s Spring 2010 Release is finally here, and with it,...
2. Success! Tags We have added in a small feature you may not...
3. Editing CSS in New Webforms Using custom CSS in a webform can be a great...

As mentioned, with our Fall 2009 release, we now support relative dates in segments. This means you can now specify a number and a time frame (hours, days, weeks, months, years,etc) in a segment. The dates being used are relative to the time the segment is processed. For example, lets say you wanted to find any contact in your Bronto account that was created in the last 3 days. The segment may look like this: (Click the image to enlarge)

Another example might be to pull a list of contacts that have purchased in the last 30 days. If you are storing a last purchase date as a field in Bronto, you can use the segment builder to build a segment comprised of these contacts. An example could look like this: (Click to the image to enlarge)

Obviously, there will be many more uses for this new feature. For more information about segmenting on relative dates, click on the Creating Segments: Detailed Explanation help guide available on the Help For This Page on any of the segment pages in the Bronto application.

We would love to hear how you are implementing this feature in Bronto and what success you are having with it. Leave us a comment and share your thoughts!

Rob Slade
Client Support Specialist at Bronto

Related posts:

1. Last Minute Holiday Segments With the Holiday season almost here, I wanted to share...
2. Advanced Segmentation With Additional Rules And Criteria In my last post, I looked at the basics of...
3. DIY Integrations II: Updating Contact Field Information With Direct Update Integrating your website or database with a third party...

You may not have noticed, but we have recently added some additional fields to the contact view in the application. If you are tracking conversions within Bronto you will now be able to see the total number of conversions as well as total conversion value for each contact.

We have also recently added this information to the detailed contact overview. This means that if you look up a specific contact you can see what they were sent, whether or not they opened or click, as well as any conversions they made.

If you aren’t tracking conversions, I highly recommend it. It’s very easy to add to your website and provides you with detailed information about how email marketing is affecting your sales.

Related posts:

1. Tis The Conversion Season The holiday season is already upon us, and for many...
2. Dynamically Adding Values To Conversion Tracking URLs In recent weeks, I have been getting a lot of...