Got a 'How do I' question? Join our live 'Ask a Trainer' session happening now for instant help and pro tips!

V3 API - retrieving suspended users?

user636310
Rookie
0 Votes

I have our CRM system synching contacts with CC.

When users unsubscribe our system retrieves these updates and marks them as unsubscribed in the CRM also. 

 

Today our subscriber numbers on our main mailing list went out of sync.

After some investigation we had two email addresses that appeared to have vanished in CC - we had a contact_id on file in our database for them, but no matter how we searched under 'contacts' in CC they weren't showing up.

We pushed the contacts back through and the mailing lists were back in sync.

 

I can now see these two users in the CC Interface and under engagement there's a mention of 'Bounced as non-existent' - why when users have this flag are the hidden in the interface?

 

How can I retrieve the users flagged as this/suspended to update our own system?
There doesn't seem to be an option to retrieve suspended users with the /v3/contacts/?status= API calls..?

Thanks,
Steve

1 REPLY 1
Courtney_E
Moderator
0 Votes

Hello user636310,

 

Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.

 

Contacts that bounce as Non-Existent email addresses in response to an email send will still be active/subscribed and visible within the Contacts tab of the UI, as well as searchable via the API as active contacts unless they have been deleted by someone who manages your account. If an email could not be delivered to that address, it does not mean that they will be unsubscribed. 

 

Managing, removing, and preventing bounced emails

http://knowledgebase.constantcontact.com/articles/KnowledgeBase/5288-understanding-managing-and-remo...

 

As far as your unsubscribed contacts being out of sync between Constant Contact and your CRM, that would be caused by other factors that are unrelated to bounces. However, if you're still having an issue with this, please feel free to reach out to us directly by email with the case number listed at the end of this post.

 

Currently we offer two ways to determine which contacts have bounced. You can search by campaign, to see a list of bounced contacts and the reason for the bounce (ex: non-existent), or you can search by individual contact. I'll list those endpoints for you below.

 

Use the V3 API to Retrieve Bounces by Campaign :

 

  • First, retrieve the "campaign_id" for campaign(s) with current_status": "Done".

GET a Collection of Email Campaigns
https://developer.constantcontact.com/api_reference/index.html#!/Email_Campaigns/retrieveEmailCampai...

 

  • Next, use the "campaign_id" to get the "campaign_activity_id" for the "role": "primary_email".

GET Details About a Single Email Campaign

https://developer.constantcontact.com/api_reference/index.html#!/Email_Campaigns/retrieveEmailCampai...

 

  • Next, use the "campaign_id" to retrieve the contacts who bounced for that campaign, and why they bounced.

GET an Email Bounces Report (bounce key in right column, you can narrow by type as well)

https://developer.constantcontact.com/api_reference/index.html#!/Email_Reporting/getBounces

 

Use the V3 API to Retrieve bounces by contact:

 

  • First, get the Contact "contact_id"(s) for the contact or group of contacts that you'll be checking for bounces.

GET Contacts Collection

https://developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts

 

  • Next, use the "contact_id" and the tracking_activities_list parameter "em_bounces" to see which sent campaigns the contact was bounced from. This will not show you the bounce reason, but will list the "campaign_activity_id" which can be used as outlined above to obtain more detail.

GET Contact Activity Details

https://developer.constantcontact.com/api_reference/index.html#!/Contacts_Reporting/getContactTracki...

 

We'd be happy to look further into your unsubscribed contacts being out of sync between Constant Contact and your CRM, and/or the contacts that you were having difficulty locating within the system that had previously bounced as non-existant.. 

 

Please feel free to email our team directly at webservices@constantcontact.com  with the email addresses in question, and/or any additional details about the discrepancies you were experiencing and reference case #30197488.

 

Please have a look and let us know if you have any other questions!


Regards,

Courtney E.
Tier II API Support Engineer

Did I answer your question?
If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.
Resources
Developer Portal

View API documentation, code samples, get your API key.

Visit Page

Announcements

API Updates

Join our list to be notified of new features and updates to our V3 API.

Sign Up

Polls
How confident are you about the effectiveness of your current marketing strategy?

Top Choice: Not confident at all (77%)