Knowledge Base/Advanced Features: Integrations/IconCMO

How to Integrate With IconCMO's API-Classic View

Matt Ahern
posted this on February 19, 2011 06:02

If your IconCMO application does not look like the following image, click here.

icon_classic_view.JPG


IconCMO API Setup

To configure BombBomb to integrate with your Icon account, you will need to have your Icon API login and password.  This is different than your main Icon user login and password.  To create your API login info, log in to Icon like you normally would, then select WS Setup from the Web Services menu item. 

icon_classic_web-services.png

Then select the Web Service Security tab.

icon_classic_web-service-security.png

Then, add a user and password and click Save User. This will be the username and password you use for the API login in BombBomb. 

icon_classic_add-api-usr.PNG

Add the following security settings for this user in the bottom panel of the Web Service Security screen.

icon_classic_api_user_security_settings.png

Select Groups: Household Groups from the "List of Functions" drop down list, select Read then select the Set Security button.

You will be asked to confirm that you want to Change the Security, select the OK button to confirm.

icon_api_user_security_settings_confirm.JPG

You will see Save Succeeded below the Set Security button and the new security access added to the Web Services Function list to the right when it has completed setting the new security.

Do the same for each of the other security settings of, Groups: Member Groups, Membership: Email Names, Membership: Households and Membership: Members security settings. The only access needed is Read.

The BombBomb app is not designed to Create, Update or Delete items in the IconCMO application. It can only retrieve items. This is by design to protect the information in your IconCMO application.

 

IconCMO API User setup in the IconCMO application is complete.

BombBomb API Setup

Log in to your BombBomb account and select the My Profile link at the top-right of the page.

Select the Integrations link

myprofile-int-link.png

 

Select IconCMO and enter your IconCMO API username and password you created in the steps above and the phone number associated with your Icon account then select the Save my ICON Integration button.

integrations-page-icon-selected.PNG

 

Integration Active is displayed.

int-icon-active.png

 

Select the Lists tab. Select the "sync lists from ICON". You Icon groups are represented as lists in BombBomb.

Note: If you do not see the sync lists from ICON link then select the green, "create" button, save the list with the default date-name provided then select the Lists tab again. You should now see the sync lists from ICON link.

icon-sync-lists.png

 

Upon clicking the sync lists from ICON link you are shown that lists are synchronizing.

lists-sync-icon.png

When ever you make a new group in Icon, select the sync lists link to update BombBomb.