mailkit.campaigns.schedule.cancel

Function mailkit.campaigns.schedule.cancel cancels an already scheduled delivery.

API call example:

JSON 

{  
   "function":"mailkit.campaign.schedule.cancel",
   "id":"client_id",
   "md5":"client_md5",
     "parameters":{  
      "ID_message": "123456",
      "ID_send_message_queue":"123"
   }   
}

XML 

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
 <methodName>mailkit.campaigns.schedule.cancel</methodName>
 <params>
  <param>
   <value>
    <int>client_id</int>
   </value>
  </param>
  <param>
   <value>
    <string>client_md5</string>
   </value>
  </param>
  <param>
   <value>
    <i4>123456</i4>
   </value>
  </param>
  <param>
   <value>
    <struct>
     <member>
      <name>ID_send_message_queue</name>
      <value>
       <string>123</string>
      </value>
     </member>
    </struct>
   </value>
  </param>
 </params>
</methodCall>

Values

client_id * = client ID can be found in your Mailkit account's menu Profile/Integration.
client_md5 * = MD5 code can be found in your Mailkit account's menu Profile/Integration.
ID_message = ID of campaign (optional). When used returns only campaign with a given ID.ID_send_message_queue * = ID of the scheduled delivery (as returned by mailkit.campaigns.schedule.list)

* required value

Successful call response:

JSON 

{
    "error_status": 0,
    "error": "Canceled"
}

XML 

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
 <params>
  <param>
   <value>
    <string>Canceled</string>
   </value>
  </param>
 </params>
</methodResponse>

Values

Canceled = pending delivery has been cancelled

Unsuccessful call response:

JSON 

{
    "error_status": 1,
    "error": "Invalid ID_message"
}

XML 

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
 <params>
  <param>
   <value>
    <string>Missing ID_message</string>
   </value>
  </param>
 </params>
</methodResponse>

Values

On error / error_status = 1 ... an error occured:
Invalid ID_message = invalid message ID
Invalid status cancel = invalid ID of a pending delivery to cancel (already cancelled or delivered)
Invalid ID_send_message_queue = invalid ID of a pending delivery