The simplest way to subscribe
http(s)://edm.lapaton.com/api/<api_key>/subscribe?listId=123
&email=joe@example.com
&isSafeSubscribe=1
Response
{
"success": true,
"responseCode": 1,
"message": "Successfully subscribed"
}
The full function subscribe
http(s)://edm.lapaton.com/api/<api_key>/subscribe?listId=<list_id>
&email=<email_address>
&isSafeSubscribe=<0 or 1>
&firstName=<first_name>
&lastName=<last_name>
&phone=<phone>
&fax=<fax>
&address1=<address_line_1>
&address2=<address_line_2>
&city=<city>
&country=<country_code>
&gender=<gender>
&businessName=<business_name>
&businessEmail=<business_email>
&businessAddress=<business_address>
&<custom_field_name_1>=<custom_field_value_1>
&<custom_field_name_2>=<custom_field_value_2>
A brief explanation
listId: the id of the contact list, can be found in Contact > Manage Lists
email: must be in valid email address format
isSafeSubscribe: optional, default value is 1 if missing, possible value is 0 or 1
0: if the email exist, the subscription status will be changed to subscribe even it is un-subscribed or bounced
1: if the email exist, it will NOT subscribe the email if status is un-subscribed or bounced, that mean the status will be unchanged
firstName: max 255 characters, if not specified, this rule applies to other text field
country: Please refer to our
country code table
gender: M, F or empty
customField: all custom fields start with 'c_', for example 'c_personal_website',
and you can retrieve the definition (all the field names and captions) by another request
here
For any fields that are not getting value in the subscription,
you can simple exclude the field in the URI request.
All response
{"success": false, "responseCode": 0,
"message": "Error"}
{"success": true, "responseCode": 1,
"message": "Successfully subscribed"}
{"success": false, "responseCode": 2,
"message": "Invalid email format"}
{"success": false, "responseCode": 3,
"message": "Exceeded the maximum subscribers limit, please upgrade the subscriber plan."}
{"success": false, "responseCode": 4,
"message": "Invalid custom field name."}
{"success": false, "responseCode": 5,
"message": "Invalid business email address."}
{"success": false, "responseCode": 6,
"message": "Invalid gender value."}
{"success": false, "responseCode": 7,
"message": "Invalid list id."}
{"success": false, "responseCode": 8,
"message": "Invalid country code."}
{"success": false, "responseCode": 9,
"message": "The email is un-subscribed in the system."}
{"success": false, "responseCode": 10,
"message": "The email is bounced in the system."}