Creating a list using API


I've never used CM before, but I need to write as much 'automated' app as I can that uses CM. I've already figured out that it's impossible to create whole campaigns using API.

But what about lists? Can I create a list using API? Or does site owner have to create a list manually on and I can only display a list of all lists he has, so he can choose a list to add selected users to?

Do you guys plan to update Ruby wrapper? It lacks adding i.e. subscribers with custom fields. I'll need it, so if I make it work, I can send you updated version.

One complain regarding responses from the API. When I try to get lists of non-existing user I get a Code=102 and a Message in XML response. When I try to get lists of existing users I don't get any code (like 200). Just tried it in Firefox. Is the Code returned only for error messages? Can I assume that if I got Code in response, then something went wrong?

Mathew Mathew, 9 years ago


Thanks for the feedback. We're actually looking at making some improvements to the API very soon, we'll post on the blog about it then, and we do always like to get useful wrappers from people that we can share with other customers.

I'll have a developer jump in on your specific questions here too.

Get in touch with us on Twitter:
We're also on Facebook:
Ken Ken, 9 years ago


Unfortunately at the moment, you can't create a new list from the API. Like you said, you have to create it manually in your account before you can use the API to add subscribers to it.

I'm afraid that we don't have any immediate plans to update the Ruby wrapper. We don't provide direct support to the Ruby wrapper as it has been provided to us by another user who uses the API with Ruby. It's possible that another API user who uses Ruby and has read this post might be able to give you a hand.

I'm guessing you're using the Subscribers.GetActive method. If you are, then you are correct. If you get a code, then something has gone wrong. If your API call was successful, then you should receive a collection of Subscribers.

I hope that answers your questions. Feel free to get back to us if you have any other problems or questions.

200,000 companies around the world can't be wrong.

From Australia to Zimbabwe, and everywhere in between, companies count on 
Campaign Monitor for email campaigns that drive real business results.

Get started for free