Get a list of contacts with a email status


(Dominik Klein) #1

How can i get a list of contacts with a email status, e.g. all ‘hard bounces’? Is this possible with the REST-API https://developer.infusionsoft.com/docs/rest/#!/Contact/listContactsUsingGET or do you have a other solution for this?

Thanks for your help.


(Tom Scott) #2

@Dominik_Klein, we do not currently have a filter on the EmailStatus of Contacts, but I can pass along the request to our product manager and see if we can get it worked in.


(Dominik Klein) #3

@TomScott, thanks for the feedback.

Do i have a other possibility to become a list like this or do i have the possibilty to trigger a action to a external system if the status was changed for a contact in infusionsoft? I see something like “post actions” in the actions? Is something like this possible?

If the product manager agree to add something like this, how long do you think is the time range for this?


(John Borelli) #4

@Dominik_Klein,

Yes you can do this with the api using saved searches. Goto Marketing->Reports. Edit the search criteria to only include hard bounces. When you have that list click save and give it a name. Having done that, you can call that saved search to get you realtime data results for hard bounces with the api’s search object’s savedSearchAllFields method.

https://developer.infusionsoft.com/docs/xml-rpc/#search-retrieve-a-complete-report-from-a-saved-search


(Dominik Klein) #5

But not with the REST API or?


(John Borelli) #6

REST is still in development and does not yet have that functionality. However, the oauth token you would use for REST is also valid for use with the api.

Although, if you used email status automation, you could raise a tag when someone hard bounced and then you could use REST Webhooks to capture that tag getting raised and act accordingly.


(Dominik Klein) #7

Do you have list, with all events which are available for the REST Webhooks?

Or what do you mean with the tag for email status? Can i add a action which add a tag to a user, if the email status was switched?


(John Borelli) #8

The REST interactive IO docs have a List Hooks Event Types call that will give you currently available hook triggers:

https://developer.infusionsoft.com/docs/rest/#!/REST_Hooks/list_hook_event_types


(Dominik Klein) #9

Ok, i have the list:

[“appointment.add”,“appointment.delete”,“appointment.edit”,“company.add”,“company.delete”,“company.edit”,“contact.add”,“contact.delete”,“contact.edit”,“contactGroup.add”,“contactGroup.applied”,“contactGroup.delete”,“contactGroup.edit”,“contactGroup.removed”,“invoice.add”,“invoice.delete”,“invoice.edit”,“invoice.payment.add”,“invoice.payment.delete”,“invoice.payment.edit”,“leadsource.add”,“leadsource.delete”,“leadsource.edit”,“note.add”,“note.delete”,“note.edit”,“opportunity.add”,“opportunity.delete”,“opportunity.edit”,“opportunity.stage_move”,“order.add”,“order.delete”,“order.edit”,“product.add”,“product.delete”,“product.edit”,“subscription.add”,“subscription.delete”,“subscription.edit”,“task.add”,“task.delete”,“task.edit”]

What do you think is the best event? I don’t see something special for status or tag add? Or do you mean that i should use contact.edit and check if the user hast the tag assigned? And how can i add a tag automaticlly after a hard bounced?


(Tom Scott) #10

The one you would watch for tags is contactGroup.add.


(John Borelli) #11

Tags are called Groups in terms of parlance (hold over from the original table designs). So all of your Groupxxx.xxxx triggers involve tags.


(Dominik Klein) #12

In General in understand the idea and i think it can work, but how it is possible to add automatically a tag to a contact if the email-status is changed to opt-out or hard bounced? I found only somehting for email status opt-out.


(John Borelli) #13

You have email status automation that can trigger that for you.


(Dominik Klein) #14

But i see only something for the stastus opt-out in the actions sets, but not hard bounces or i am in the wrong area. Do you have a link to a documentation or maybe can send me a screenshot or short description?


(John Borelli) #15

It’s there… you can cover just about any email response using automation (see image of how we are setup)… goto Marketing->Settings