API - Get Contact ID by Email Address

SOLVED
Go to solution
AlexM760
Campaign Contributor
0 Votes

Hello,

 

I'm trying to modify specific users' subscribed lists. The problem is that I don't have their Contact ID, just their email address and other personal information. Is there a way using the API to retrieve their Contact ID by email address to update that users' subscribed lists?

 

If I try to add the user to Contacts, the API comes back with an error that the user already exists, and in the error message, it has the users' Contact ID. I can parse the ID from the string but doesn't feel reliable, and I was hoping the API had an actually way to retrieve the Contact ID in a better / more reliable manner.

1 ACCEPTED SOLUTION
Courtney_E
Moderator

Hello AlexM760,

 

Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.

 

To get V3 API contact IDs, you’ll want to make a GET call to the Contacts endpoint:

GET https://api.cc.email/v3/contacts

 

If you are looking for the contact ID of a specific email address, you can add that as a parameter like so:

GET https://api.cc.email/v3/contacts?email=email@domain.com

 

You can make this call through your platform, or you can just use our V3 API tester which I have linked below. You'll need to be logged into the account that you are retrieving contact data from when using the tester.

 

V3 API tester: GET Contacts Collection
https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts

 

Please have a look and let us know if you have any other questions!


Regards,

Courtney E.
Tier II API Support Engineer

Did I answer your question?
If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.

View solution in original post

1 REPLY 1
Courtney_E
Moderator

Hello AlexM760,

 

Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.

 

To get V3 API contact IDs, you’ll want to make a GET call to the Contacts endpoint:

GET https://api.cc.email/v3/contacts

 

If you are looking for the contact ID of a specific email address, you can add that as a parameter like so:

GET https://api.cc.email/v3/contacts?email=email@domain.com

 

You can make this call through your platform, or you can just use our V3 API tester which I have linked below. You'll need to be logged into the account that you are retrieving contact data from when using the tester.

 

V3 API tester: GET Contacts Collection
https://v3.developer.constantcontact.com/api_reference/index.html#!/Contacts/getContacts

 

Please have a look and let us know if you have any other questions!


Regards,

Courtney E.
Tier II API Support Engineer

Did I answer your question?
If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.
Resources
Developer Portal

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

Visit Page

Announcements

API Updates

Join our list to be notified of new features and updates to our V3 API.

Sign Up

Polls
How confident are you about the effectiveness of your current marketing strategy?

Top Choice: Not confident at all (73%)