Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Warning

This API is not complete. It is not yet scheduled for development. A single API call was created (subscribe) to meet the needs of merchants. The remainder of this API will be completed in 2014+. Thanks.

 

Table of Contents

...

/rest/autoresponder/subscribe

Method
GET
Comments
Descriptionenrolls a customer into a campaign

 

Cookies

none

 
Path Parametersnone

 

Query Parameters

_mid

campaignOid

email

name

Merchant ID ( this can also be passed as a cookie or header – see notes in the Introduction) 

Integer, campaign id. You may find this on the main Auto Responder page in the Campaigns table. It's the first column.

Email of customer to enroll

Optional first and last name. If this is null, the email is inserted in this field also

Headers

none

 
Receives Jsonnone 
Returns JsonNone. Plain Text

Here are the various return messages:

success. re-enrolled.

success

failure. already enrolled and no re-enrollment.

failure. customer is enrolled and in-progress. nothing done.

 

 

Discussion:

If the customer does not exist in the campaign and everything works, success is returned.

If the customer exists, and in a finished state, and the campaign is set to re-enroll, then the customer is re-enrolled and success. re-enrolled. is returned.

If the customer exists and the campaign is not configured for re-enrollment, failure. already enrolled and no re-enrollment. is returned.

If the customer exists and re-enrollment is turned on, yet the customer is in progress, nothing is done and

failure. customer is enrolled and in-progress. nothing done.

 is returned.


It's important to realize the none of the above conditions are bad. Each message above is indicative of a healthy auto responder. success/failure pertains to enroll, but regards business logic.

 

If there is a server error, a 500 status code will return. If there is invalid or missing parameters, a 400 status code will return. Those are the issues you need to worry about.

...