Use the /promote endpoint to promote a subscriber.

You can promote only subscribers who have verified their email address, otherwise you will get a subscriber_not_found error.

Example URI

URI Parameters

uuid string
(required) Your widget UUID.

api_token string
(required) Your api_token.

email string
(required) Your subscriber's email.


200  success

  status: "ok",
  data: {
    response: "subscriber_promoted",
    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_already_promoted
  • subscriber_not_found
  • too_many_calls

Still need help? Contact Us Contact Us