/unpromote

Use the /unpromote endpoint to remove a subscriber from the "promoted" list.

You can unpromote only subscribers who have are in the promoted list, otherwise you will get a subscriber_not_found error.

Example URI
https://maitreapp.co/api/v1/list/unpromote?uuid=XXX&api_token=YYY&email=john.doe@email.com


URI Parameters

uuid string
(required) Your widget UUID.

api_token string
(required) Your api_token.

email string
(required) Your subscriber's email.


Response

200  success

{
  status: "ok",
  data: {
    response: "subscriber_unpromoted",
    name: "John",
    email: "john.doe@email.com",
    code: "MFXXXX"
  },
  calls_left: 482, //Api calls left for this hour
  timestamp: 1469109759 //Timestamp request
}

4XX  error

{
  status: "error",
  message: "Error explanation" // Eg: Missing API token
  code: "error_code" // Eg: no_token
}

Possible error codes

  • no_token
  • no_list_uuid
  • invalid_list_or_token
  • no_email_address
  • subscriber_not_found
  • too_many_calls

Still need help? Contact Us Contact Us