Any Complete Examples of POST a new CONTACT API?


Any Complete Examples of POST a new CONTACT API?

Hello. My first use of API and I need a push in the right direction more than what the web site documentation gives.


My application is very simple:


I require HTML code (I use PHP or JS executable statements) to add a CONTACT to my CC list from variables that I have already gotten filled in from another form (Chrono Forms integrated with my Joomla).  I don't want another form that the users have to reenter the same data.


For a test I did add contacts with the form that CC provided for HTML but I don't want to use that form since the data were already entered into another form; I just want to use the POST of existing data


For learning the samples given I copied the JSON request body from


then pasted that example into post contact method



Response BodySelect content

[{      "error_key":"json.payload.invalid",      "error_message":"Unable to parse JSON payload."  }]

and yes I did notice that the line numbers from the example had to be removed.


Looking for more examples I notice that this sample code page is empty


This works perfectly but I want to get rid of the form and formstack since Joomla/ChronoForm already has the data and I don't want to mess with Joomla/ChronoForm integration ,upgrades, etc:


<form method="post" action="">

<input type="hidden" name="form" value="hide my form number" />

<input type="hidden" name="viewkey" value="hide my key" />

<input type="hidden" name="email" value="" />

<input type="hidden" name="custom_field_1" value="" />

<input type="hidden" name="custom_field_2" value="" />

<input type="hidden" name="first_name" value="" />

<input type="submit" />



Is there a complete example?  Everything from

<!DOCTYPE html>


... through to the end ...






I think your browser has an issue showing the content on the Samples page.  It should look like this, with selectable tabs.


Here are our sample signup forms, all hosted in Github with their respective libraries:



In Ruby

In C#


You would need to download the approrpriate library/sdk for those to work.


Best Regards,

Shannon W.

API Support Specialist

Hi, how are you? I need your help, do you have some example in ASP Classic, i cant find anywhere, 
I greatly appreciate if you could help me



Unfortunately, we do not provide any resources for ASP applications due ot the smaller number of developers still using classic ASP, and we do not currently have plans to develop new resources.

Even though we do not have any resources that we provide directly, there is a thread in the developer community where some of our customers have developed a classic ASP sample for adding contacts with our V1 API. You can find that here: 

If you need to create an API key for V1 or access documentation, both of those can be found on the lower part of the page at



Elijah G.

Tier 2 Support

Elijah G.
API Support Engineer

We'll keep an eye on traffic coming in on requests for Classic ASP.  If there is enough interest, we will investigate adding a wrapper for that language.


It could be worth creating a new open source project on Github around this and seeing if there are additional developers who want to contribute as well.  We are more than happy to promote any open source projects around our API to the community at large and assist in developing them as best we can.

Dave Berard
Senior Product Manager, Constant Contact
Developer Portal

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

Visit Page