API: get the list id in ConstantContact interface

SOLVED
Highlighted
Moderator

Re: API: get the list id in ConstantContact interface

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

Highlighted
Occasional Participant

Re: API: get the list id in ConstantContact interface

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.  

Highlighted
Occasional Visitor

Re: API: get the list id in ConstantContact interface

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.

Highlighted
Moderator

Re: API: get the list id in ConstantContact interface

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
Highlighted
Occasional Visitor

Re: API: get the list id in ConstantContact interface

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.

Highlighted
Member

Re: API: get the list id in ConstantContact interface

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!

Highlighted
Regular Visitor

Re: API: get the list id in ConstantContact interface

It worked for me. Thank you very much

Highlighted
Occasional Visitor

Re: API: get the list id in ConstantContact interface

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!

Highlighted

Re: API: get the list id in ConstantContact interface

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

Highlighted
Honored Contributor

Re: API: get the list id in ConstantContact interface

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
Developer Portal

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

Constant Contact Would Like To Hear From You!

We want to hear from customers like you about your favorite features and how they have helped your business or organization. Tell us by answering a few questions in...

Read More
Featured