API to replace contacts to a list each time - instead of add contacts to a list

Health Practitioners & Centers

API to replace contacts to a list each time - instead of add contacts to a list



We are developing the API for adding lists, adding contacts to those lists and adding campaigns.


We have around 4,000 contacts and many many lists that are being updated with different contacts on an ongoing basis.


The ONE questions we have right now..  is



What API do we need to replace all the contacts each time we update a list – In other words, we do not want to ‘add’ contacts to a list, but instead replace the list with the new uploaded contacts each time.



Greatly appreciated your prompt response.






Hey Alberto,


You can use the clear contacts activity to remove all contacts from the list, then upload the contacts you need. This bulk activity does require our server to process it, so it can take some time for all contacts to be removed from the list, but you can also check the status of the activity using the activity URI.


Let us know if you have any questions on this. Thanks!

Nick Galbraith
Support Engineer
Health Practitioners & Centers

Hi... not sure how much has changed since version 1 to v2 of the API.. so I have these questions:


1.  Is this link still valid to create e-mails.. https://community.constantcontact.com/t5/Developer-Support-ask-questions/Dynamic-links-in-custom-xht... for the API


2. Can I create an API with HTML - and/or can it only be done with XHTML?


3.  Do I need to do inline css and or can I use styles in html and xtml in both custom e-mail  and/or API?


4. Will it in both cases ie.. custom and API convert the styles to inline and as example us the 'font' in the code so that the emails shows up correctly in all the e-mail clients?


4. For the tracking... how many fiels are actually required for images?


href="http://www.yoursite.com" >
<a href="http://www.yoursite.com"><img src="http://img.constantcontact.com/ui/images1/cc_mainlogo.gif" alt="Image Description" title="Image Mouseover" border="0" /></a>


why do we havea href and a href?

and what is the title   - is it needed?





Lots of questions, here's the best answers I can provide:


1. For the v2 API, here is the correct documentation: http://developer.constantcontact.com/docs/email-campaigns/email-campaigns-collection.html?method=POS...


2. If you are not looking to use dynamic content, such as dynamic links or demographic data, you can create a custom HTML campaign.  If you are looking for any type of merged data outside of a Greeting, you would need to use XHTML.


3. We recommend inlining the CSS as that works best in most email clients.  If you are using XHTML, we do offer a Stylesheet option and we will inline the CSS at send time for you.  If you are looking for maximum control over how the email is delivered, you would want to inline the CSS yourself.  You can use <style></style> tags in your HTML document you send over to use CSS as part of the email.  We will not inline that for you, but many email clients will inline that to prevent any class conflicts with their CSS (injection attacks) that could comprimise their UI.  You could get unexpected behaviors with this method, especially in GMail or Hotmail (Live/Outlook). 


4. This is only required if you are looking to use XHTML.  If you use HTML, all links are tracked by default.  You would want to read up more on using custom XHTML in our Advanced Users Guide found here: http://img.constantcontact.com/docs/pdf/building-your-emails-with-the-advanced-editor-tool-constant-...

Dave Berard
Senior Product Manager, Constant Contact
Developer Portal

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

Visit Page