We all started somewhere! Share your experience on the Get Advice: Let's Get Started Sweepstakes thread and be entered to win a $100 credit on your Constant Contact account.

Contact List Status Attribute


Contact List Status Attribute

In the past, there was a way to set the STATUS attribute within the Constan Contact UI. We are using the API to pull a list of Contact Lists and display the ACTIVE ones on a form. Essentially buuilding our own custom sign up form.


With the new Contact and List upgrades, we're unable to see how the status attribute can be set? It is always HIDDEN with the exception of the default lsit.


Any suggestions on where this can be set within constant contact UI?


"name":"List #2",
"name":"General Interest",

Hello Jay,


Because we have made significant changes to how our signup forms and list management works, this property is no longer managed through the UI. This is because now that you can have multiple signup forms and customize each form, the use of a single unified default list is no longer a factor for the signup forms.


Because of this, the only way to change this status is to make the changes through the API by making a PUT request to update that specific list.


If you are interested in how to accomplish that, you can find documentation on that process here: http://developer.constantcontact.com/docs/contact-list-api/contactlist-resource.html?method=PUT


If you do have any additional questions, please let me know!



Elijah G.
API Support Engineer



Following up with a very similar situation to the original poster.


If the status property of contact lists is deprecated in the ConstantContact UI and there is no way through the API to access forms created through the UI, then how exactly is one supposed to define which contact lists should and should not appear on a given website without building their own admin?



If you are working with the Constant Contact provided sign-up forms, we provide the ability to select your lists on a per-form basis, rather than only being able to select once for all lists. When this change was introduced, it was no longer required to have this status property per list, since it is now handled per form. You can read about signup forms here: https://knowledgebase.constantcontact.com/articles/KnowledgeBase/5300-overview-list-growth-tools


If you are working in the API to create a custom form, you are given the ability to specify the list(s) by ID that you wish to use any time you take an action that involves list memberships. In addition to this, the API provides an endpoint that can be used to get these IDs for all of our lists. You can find documentation for that here: http://developer.constantcontact.com/docs/contact-list-api/contactlist-collection.html


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



Elijah G.
API Support Engineer

To follow up on this, is there any behavioral differences between an ACTIVE versus a HIDDEN list..or for the purposes of subscribing contacts to (and moving them between) lists, can this be ignored.



This status is a holdover from our previous contacts system where you could only have one signup form. The status of a list (ACTIVE or HIDDEN) determined if it would be a default list for your account's signup form. For the purposes of adding and moving contacts, this status does not have any real effect and can be ignored.


David B.
Tier II API Support Engineer



Developer Portal

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

Visit Page