API: get the list id in ConstantContact interface

SOLVED
Go to solution
tops6
Regular Participant

API: get the list id in ConstantContact interface

Hi,

 

I am looking for the lists ids in the constant contact user interface but I can't figure where it is.

 

I would like to find it in order to use the getList method

 

Helpdesk is redirecting me here, so I hope you will be able to help me :)

 

Thanks

1 ACCEPTED SOLUTION

Sorry for the delay getting a response.  There is no way through our product to get the List ID numbers anymore.  The List ID number is only useful for developers who are using our API, which is why it isn't exposed in the UI anymore.

 

To get the List ID, you would need to use the API to make a call to get the collection of lists.  Our documentation for doing this can be found here: http://developer.constantcontact.com/docs/contact-list-api/contactlist-collection.html.  If you are using an integration developed by a 3rd party developer, I would recommend contacting the developer of that integration as there is no other way to get the list IDs.  We do not recommend any integrations developed to ask the user to provide a list ID number, they should instead provide a way to select one or more lists to the user.  If they need assistance with that, we can provide that as needed.

Dave Berard
Senior Product Manager, Constant Contact

View solution in original post

22 REPLIES 22
tops6
Regular Participant

No response from support by email, no response here.

 

Thank you, great service.

Sorry for the delay getting a response.  There is no way through our product to get the List ID numbers anymore.  The List ID number is only useful for developers who are using our API, which is why it isn't exposed in the UI anymore.

 

To get the List ID, you would need to use the API to make a call to get the collection of lists.  Our documentation for doing this can be found here: http://developer.constantcontact.com/docs/contact-list-api/contactlist-collection.html.  If you are using an integration developed by a 3rd party developer, I would recommend contacting the developer of that integration as there is no other way to get the list IDs.  We do not recommend any integrations developed to ask the user to provide a list ID number, they should instead provide a way to select one or more lists to the user.  If they need assistance with that, we can provide that as needed.

Dave Berard
Senior Product Manager, Constant Contact

View solution in original post

tops6
Regular Participant

Thank you for having taken the time to respond

Are you effing serious? We have to write a bunch of code to get a flipping two digit number? Why not just display it somewhere on the UI? How effing hard would that be? Mainly annoyed because I can't even get your "Need an access token" button to work on your mashery page, i.e. it's broken with an unintelligible error. So basically what should take all of two seconds is now going to take me about a half hour. thank you!

DavidS48376
Occasional Participant

DaveBerard, your claim that, "The List ID number is only useful for developers who are using our API..." is not really accurate. I'm a developer and need to remove contacts from a list through the API, but I need to be specific about which list they are removed from based on activity they've performed on my website. The only way I would have of identifying a contact's "correct" list is if the ConstantContact account owner feeds the list ID it into my system to begin with.

 

I've performed this exact same style of integration with MailChimp and Real Magnet, both of whom permit a list to be accurately identified. I wish Constant Contact did also. Until then, it appears I'll not be able to integrate my system with Constant Contact.

Hello DavidS48376,

 

There are a few other options listed in this thread for how to get the list ID without using the API; however from what you described it sounds like you would be able to use our API to get the list IDs needed for your integration. If you would like to provide details about your process I'd be happy to see if there is some way to come up with a solution. Please send us an email at webservices@constantcontact.com.


Regards,
Jimmy D.
Tier II API Support Engineer

I can't imagine a reason NOT to add the list ID to the UI, especially considering how trivial it would be for you to do it.  Here's a good reason why it should be there:  Let's say I'm a developer, and I'm taking over a project where your API has been implemented to add users to a list when the user submits a form.  Now the client has a new list and wants me to have users go to that list instead.  I can clearly see where to update the list ID in the existing code, but what is the list ID of this new list???

 

You see, just because a developer is working with your API doesn't mean that developer has time to get to know your API, or has any good reason to.  In this scenario, having the list ID available in the UI would save a developer time, and keep them from thinking bad thoughts about Constant Contact.

 

You can simply add the ID as a data-id on the html element containing the list name, just as you've added your internal ID (I guess that's what that is) to the tr element.  Developers will find that quickly.  You don't have to change the look and feel of your UI.

Hi @ChristianM614,

 

This is a very good use case and I will pass this along.


Regards,
Jimmy D.
Tier II API Support Engineer
WilliamG916
Occasional Participant

I completely agree. You all are not thinking like actual users, but rather developers yourselves...

 

Showing the id makes it easier for your customer to complete a signup form....

Enter the id of the list you would like to use.... 

 

 

Technology is not supposed to make life harder. Its supposed to make it easier for everyone.

 

Hi William,

 

Thank you for that feedback.

 

The main reason that the List ID is not shown in the UI is because it is only used with our API. Since we offer an easy way for developers to get all lists on an account with the API, the best experience for users is to select the list directly within the application, rather than trying to hunt down an ID in the UI. List IDs can also easily be obtained by the developer without having to build anything by using our API Tester (https://constantcontact.mashery.com/io-docs).

 

Regards,
David Bornstein
Tier II API Support Engineer

ChristianM614
Frequent Participant

Thanks David, but to my point, I think I did use the link you provided a few months ago to get the list ID I needed, and I have already forgotten that that's how I did that.  It's very natural to go to the list of lists and hunt for an ID.  

CobyT4
Occasional Participant

Hi David,

 

Here's another use-case you appear not to have considered. Our client manages different lists across their various teams, and different pages where they might want to display simple signup forms for those lists.

 

In our backend UI for managing the pages, we want to allow the client to configure a signup form for a given List. We take care of making sure signups through that form get to the right place through API calls and such, but we don't want our non-techie client to have to know anything about APIs, JSON, or any of that. We certainly don't want them to have to muck around in Dev Tools. For our client to have to come to us every time they want to create a signup form for a List they don't have one for yet (not to mention us having to reread the docs and make an API call inside a specialized tool, having forgotten since the last time we did it) creates a bottleneck, and a rather tedious experience overall.

 

So while it's true that it's "only for use with the API," that is not a reason to only expose it to developers.

 

Adding the ID to the UI addresses all of this quite simply. Until you add it back there's not really a good solution for this use-case.

Hi @CobyT4,

 

The best case scenario is that a developer would put in their UI a way for their users to select the list for the sign-up form. This is how the API is intended for use.

 

In your example you as the developer would make the API call to retrieve the customer's lists and then display them in your backend UI using perhaps a drop down menu, radio buttons, or whatever display method you chose.

 

Then your customer uses your UI to create their sign-up form and when it comes time to select the list they have the lists from their Constant Contact account already displaying and ready for them to select. For example here is a screenshot from our own first party integration for WordPress plugin which uses the v2 API.

wordpress-contact-form-add-new-form-constant-contact-list-drop-down-menu-step4

 

We are not against discussing other use cases and potentially making changes. At this time I'm just wondering why an integration would not offer the lists in the UI versus making the customer go anywhere to get the listID, even if that is asking the customer to log in to the Constant Contact website?


Regards,
Jimmy D.
Tier II API Support Engineer
CobyT4
Occasional Participant

Hi Jimmy,

 

Thanks for responding.

 

> At this time I'm just wondering why an integration would not offer the lists in the UI versus making the customer go anywhere to get the listID, even if that is asking the customer to log in to the Constant Contact website?

 

Because we have a limited budget, and more important problems to solve for our client than a bespoke UI for picking List IDs, if we can accomplish the same by asking the client to copy and paste a number.

 

But, it seems you are saying that it is always preferable to build a UI and not even give the client the option to copy that number over, even if it costs them less to develop.

ReginaB41
Occasional Participant

I figured this out

 

The Constant Contact user interface is based on AJAX calls, so when you click on your lists, it makes an asynchronous call to get the lists. Included in this information is the ID you need.

 

Go to your Contacts tab,

Press F12, go to Network,

And then press the "Email Lists" link.

You'll see some new network requests, one of which ends with "lists". If you look into this request, it includes the seq_id, the number you need, for each list which is shown on the page.

 

YAY!

It worked for me. Thank you very much

ShaharH
Occasional Participant

Another option is to create a sign-up form via the Sign-up Tools and in the html, you can find the list number in it's hidden field:

<input data-id="list:input" name="list" value="1" type="hidden">

Unbelievable that this number isn't shown in the UI!

MeetMeConcepts
Regular Participant

I have no idea what you are talking about. What is a list ID and why do you want it?

The Constant Contact List IDs are used in our APIs to associate contacts and email campaigns with a specific contact list. Normally the best method to find these list IDs is to make a simple call with our API, but what is posted above is another method that can be used to get that ID.

 

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

 

Sincerely,

Elijah G.
API Support Engineer

This page made it trivial to do:

 

https://constantcontact.mashery.com/io-docs

 

You just need to provide the tokens and access information.

Developer Portal

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

Visit Page