Create a free account

Blog

News, tips and all things Campaign Monitor

API documentation and code samples get a facelift

Posted by David Greiner on December 18, 2007

Today we released a big round of updates to our API documentation and code samples to make it even easier to connect your Campaign Monitor account with your own web sites and applications. If you're a back-end developer that's right into this stuff, here's the scoop on what we've changed:

Vastly improved documentation

We've done a complete overhaul on the documentation for every method available in the API. Each method will now include the related samples that feature the method, the parameters used, return codes and sample requests and responses for SOAP, POST and GET. Check out the Subscriber.Add method to get an idea of what you can expect.

Comprehensive PHP wrapper

Thanks to incredibly generous Campaign Monitor customer and PHP developer Kaiser Shahid, we now have an all-inclusive PHP package that supports SOAP, GET and POST seamlessly. The sample also includes a complete set of functions that encapsulate every method available in the API.

Big Flash overhaul

All you Flash developers out there will be pleased to know that we've now got a much improved Flash sample ready for download. Kindly developed by Ben and the talented team at DNA Design, the sample includes a standard subscribe form as well as a more complex version supporting custom fields. The sample has also been coded in a way that makes it easy to use any of the other methods available in the API.

.NET C# and ASP samples move from the desktop to the web

For the .NET samples we have created a VisualStudio.NET 2003 project that includes example pages calling some of the different API methods available. The pages use standard ASP.NET controls and are written using the Code-Behind model. This project will also work with all newer versions of Visual Studio. We've also changed the samples from traditional desktop applications to web pages.

ColdFusion sample arrives

For all those ColdFusion developers we've now got a great API sample that includes a standards subscribe form and a more complex one supporting custom fields. The sample code will also be easy to modify to adopt any of the other methods supported by the API.

6 comments so far

Sam Farmer

wrote on December 19, 2007 2:26 AM

Nice CF examples. Could easily hook it into a form as well.

hcabbos

wrote on December 19, 2007 7:09 PM

Do you think we'll be seeing a similar update for MailBuild docs?

Dave Greiner

wrote on December 19, 2007 10:17 PM

hcabbos, we've got some ideas on new MailBuild API methods we'd like to add, so an update to that will more than likely coincide with a similar documentation update.

ashim bose

wrote on March 17, 2008 10:10 PM

Error

soap:Server: System.Web.Services.Protocols.SoapException: Server was unable to process request. ---> System.NullReferenceException: Object reference not set to an instance of an object.
at Pronto.api.api.AddSubscriber(String ApiKey, Int32 ListID, String Email, String Name, SubscriberCustomField[] CustomFields, Boolean Resubscribe, Boolean dontCheckFieldData)
at Pronto.api.api.AddSubscriber(String ApiKey, Int32 ListID, String Email, String Name, SubscriberCustomField[] CustomFields)
--- End of inner exception stack trace ---

ashim bose

wrote on March 17, 2008 10:10 PM

Can any one help me why this error is coming....


Error

soap:Server: System.Web.Services.Protocols.SoapException: Server was unable to process request. ---> System.NullReferenceException: Object reference not set to an instance of an object.
at Pronto.api.api.AddSubscriber(String ApiKey, Int32 ListID, String Email, String Name, SubscriberCustomField[] CustomFields, Boolean Resubscribe, Boolean dontCheckFieldData)
at Pronto.api.api.AddSubscriber(String ApiKey, Int32 ListID, String Email, String Name, SubscriberCustomField[] CustomFields)
--- End of inner exception stack trace ---


Ben Richardson

wrote on March 18, 2008 3:39 PM

Ashim sent this into support and we were able to help him format his SOAP request correctly which fixed the problem.

Got anything to add?

Name

Web site

Your comments (basic HTML is fine)

Search all posts

Dig into a category

Stay in the loop

Subscribe to our RSS feed

Prefer updates via email? Sign up below and we'll send you all the good bits each month.

Popular articles

Why we need standards support in email
Read why standards in HTML email are so important, and what we're doing about it.

Email design guidelines
Learn how to design for images being turned off, preview panes and other useful tips.

CSS support in email in 2007
The CSS support of every popular email environment with recommendations to boot.

Image blocking in email
A roundup of how each of the popular email clients suppress images in HTML email.

Can I use flash in email?
We test flash support in all the popular email clients. The verdict - don't do it.

Email design gallery

Our email design gallery showcases more than 150 amazing email designs sent by our talented customers.