Obtain a List ID for APIs

Get your List ID to use with APIs that require it in order to import to a list

Some Application Programming Interfaces (APIs) or plug-ins require a List ID in order to import to a specific contact list. If you need to provide a List ID you can always go through our Developer Portal or email webservices@constantcontact.com for the integration/application you are using. 

• Developers
• Non-Developers

Developers

Developers can use the built-in functionality to get lists in one of the SDKs. They can also use Constant Contact's IO docs or a REST client to make a Get /lists API call.

Non-Developers

Non-Developers can use our V3 API to retrieve List Names and List IDs from their account. List IDs are 32-digits long.

1. Open the v3 API Developer Portal.
2. Click API References.
3. Click Get Lists Collection > GET Lists Collection.
4. Scroll down to the bottom of the section and click the TRY button.
   
   
   
   
5. In the Sign In overlay, enter your username and click the Next button.
   
   
   
   
6. Enter your password and click the Verify button.
   Note: You may also be prompted to authenticate using the multi-factor authentication method you enabled for your account.
   
   
   
   
7. Review the API Reference Tester permissions and click the Allow Access button.
   
   
   
   
8. At the bottom of the Get Lists Collection section, click the Display API toggle to enable it.
9. (Optional) If you have over 50 lists within your Constant Contact account, enter "1000" into the Limit field at the top of the Query Paramaters section.
10. Click the Send Request button.
    
    
    
    
11. In the API response overlay, click Expand all.
    
     
    
    
12. View the full details of your lists including their 32-digit list IDs and List names.
    

    { 
    "list_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", 
    "name": "General Interest", 
    "favorite": false, 
    "created_at": "2021-01-00T00:00:00Z", 
    "updated_at": "2025-01-00T00:00:00Z"
    }

    
     
    
    

Important: For more help using our v3 API, please see the API Docs section of our Developer Portal.

Questions?