The Community is hosting an End of Summer sweepstakes! Participants must complete tasks to earn tickets that will enter them with a chance to win a free year of Constant Contact and other great prizes!*
*No Purchase Necessary. For Official Rules, visit here. Constant Contact’s End of Summer 2020 Sweepstakes ends on October, 20, 2020 at 11:50 PM EST.

What happens when trying to add contact who unsubscribed


What happens when trying to add contact who unsubscribed

Can you confirm what happens if our system (using the api) tries to add a contact to a new list in Constant Contact but that contact already exists and his email address is marked unsubscribed? 


1) Does this result in a non-fatal error?

2) This apparently will not add the contact to the new list. Please confirm.





Honored Contributor

Re: What happens when trying to add contact who unsubscribed

Hello Ken,


When you attempt to add a contact who is unsubscribed, the outcome depends on the API call you are using. Here are the details:


Bulk Import Contacts API:

  • The contacts that are unsubscribed will not be added to any lists.
  • The bulk import will continue and import any contacts that are not unsubscribed.


Individual Contact APIs:

  • The individual contact APIs feature a URL parameter called action_by that has two possible values: ACTION_BY_OWNER and ACTION_BY_VISITOR
  • When using ACTION_BY_OWNER you are not permitted to add an unsubscribed contact to any lists, and any attempts will result in a 400 error response from the API that will include a message explaining why the action cannot be completed.
  • When using ACTION_BY_VISITOR you are permitted to add unsubscribed contacts to lists and re-subscribe them. This is specifically because this option is only meant to be used in a scenario where the contact(visitor) is initiating the action. An ideal example is a sign-up form.

If you have any questions for me, please let me know!



Elijah G.
API Support Engineer
Developer Portal

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

Visit Page

Constant Contact 2020 End of Summer Community Sweepstakes!

The Constant Contact User Community is hosting a sweepstakes. The more you participate, the more chances you have to win! Read on to learn more...

Read More