Subscribe to mailing list through the API

Question

I am trying to subscribe a user to a mailing list through the REST API. I understand that I need to create a Contact first, then subscribe it to a given mailing list. While I can create the contact, I can't subscribe it to the list using parameters:

entity: 'MailingEventSubscribe' action: 'create' email: [the-contact-email-here] group_id: [the-mailing-list-group-id-here]

This will result in {"is_error":1,"error_message":"Subscription failed"}

The CiviVRM version here is 4.2.0 I could't find documentation for the API on this specific version, so I'm playing the guessing game here :). I've been also told that the API requests can be chained somehow in order to do just 1 instead of 2, is there a documentation for this?

Can someone point me into the right direction? Thanks.

Answer 1

The mailing list is actually a group in CiviCRM. The functionality of a group is bit more than just mailing list, but fine if you only want to use it for that.

It means that all you have to do is add the contact to the relevant group using the GroupContact API AFAIK.