• Features
  • Services
    • Email Authentication
    • Agency Partnerships
    • Email Training
    • Inbox Brand Visibility
    • Deliverability
  • Resources
    • Knowledge Base
    • API documentation
    • Blog
    • Status
    • BIMI inspector
  • About us
    • Contact
    • Terms and Conditions
    • Privacy Policy
    • Privacy recommendations
  • Features
  • Services
    • Email Authentication
    • Agency Partnerships
    • Email Training
    • Inbox Brand Visibility
    • Deliverability
  • Resources
    • Knowledge Base
    • API documentation
    • Blog
    • Status
    • BIMI inspector
  • About us
    • Contact
    • Terms and Conditions
    • Privacy Policy
    • Privacy recommendations
  • Login
    EN CS
Mailkit logo
  • Features
  • Services
    • Email Authentication
    • Agency Partnerships
    • Email Training
    • Inbox Brand Visibility
    • Deliverability
  • Resources
    • Knowledge Base
    • API documentation
    • Blog
    • Status
    • BIMI inspector
  • About us
    • Contact
    • Terms and Conditions
    • Privacy Policy
    • Privacy recommendations
  • Features
  • Services
    • Email Authentication
    • Agency Partnerships
    • Email Training
    • Inbox Brand Visibility
    • Deliverability
  • Resources
    • Knowledge Base
    • API documentation
    • Blog
    • Status
    • BIMI inspector
  • About us
    • Contact
    • Terms and Conditions
    • Privacy Policy
    • Privacy recommendations
  • Login
    EN CS
EN CS
Login
  • Mailkit
  • Resources
  • API documentation
  • Campaign management
  • mailkit.campaigns.list
    API Introduction
  • Campaign management (11)
    mailkit.campaigns.list mailkit.campaigns.create mailkit.campaigns.update mailkit.campaigns.single.schedule mailkit.campaigns.schedule.list mailkit.campaigns.schedule.timezone mailkit.campaigns.schedule.cancel mailkit.campaigns.messages mailkit.campaigns.messages.last mailkit.campaigns.messages.test mailkit.campaigns.history
  • Mailing list management (18)
    mailkit.mailinglist.list mailkit.mailinglist.create mailkit.mailinglist.delete mailkit.mailinglist.adduser mailkit.mailinglist.edituser mailkit.mailinglist.import mailkit.mailinglist.getstatus mailkit.mailinglist.unsubscribed mailkit.mailinglist.engagement mailkit.email.getstatus mailkit.email.getstatus.history mailkit.email.move mailkit.email.delete mailkit.email.unsubscribe mailkit.email.unsubscribe.getstatus mailkit.email.revalidate mailkit.email.topics mailkit.email.wipe
  • Campaign delivery (4)
    mailkit.sendmail mailkit.sendmail_mass mailkit.sendmail_mass.results mailkit.sendsms
  • Reporting (11)
    mailkit.report mailkit.report.campaign mailkit.report.message mailkit.report.message.recipients mailkit.report.message.feedback mailkit.report.message.links mailkit.report.message.links.visitors mailkit.report.message.bounces mailkit.report.raw.messages mailkit.report.raw.bounces mailkit.report.raw.responses
  • Profile (2)
    mailkit.profile.emails.list mailkit.profile.queries.list
  • Other (4)
    Event API mailkit.filemanager.upload mailkit.filemanager.list mailkit.filemanager.delete
  • Examples (3)
    PHP example 1 (Example of mailkit.mailinglist.list call) PHP example 2 (example of mailkit.campaigns.single.schedule call) PERL example of mailkit.mailinglist.adduser call
  • API Introduction
  • Campaign management
  • Mailing list management
  • Campaign delivery
  • Reporting
  • Profile
  • Other
  • Examples
API Introduction
mailkit.campaigns.list mailkit.campaigns.create mailkit.campaigns.update mailkit.campaigns.single.schedule mailkit.campaigns.schedule.list mailkit.campaigns.schedule.timezone mailkit.campaigns.schedule.cancel mailkit.campaigns.messages mailkit.campaigns.messages.last mailkit.campaigns.messages.test mailkit.campaigns.history
mailkit.mailinglist.list mailkit.mailinglist.create mailkit.mailinglist.delete mailkit.mailinglist.adduser mailkit.mailinglist.edituser mailkit.mailinglist.import mailkit.mailinglist.getstatus mailkit.mailinglist.unsubscribed mailkit.mailinglist.engagement mailkit.email.getstatus mailkit.email.getstatus.history mailkit.email.move mailkit.email.delete mailkit.email.unsubscribe mailkit.email.unsubscribe.getstatus mailkit.email.revalidate mailkit.email.topics mailkit.email.wipe
mailkit.sendmail mailkit.sendmail_mass mailkit.sendmail_mass.results mailkit.sendsms
mailkit.report mailkit.report.campaign mailkit.report.message mailkit.report.message.recipients mailkit.report.message.feedback mailkit.report.message.links mailkit.report.message.links.visitors mailkit.report.message.bounces mailkit.report.raw.messages mailkit.report.raw.bounces mailkit.report.raw.responses
mailkit.profile.emails.list mailkit.profile.queries.list
Event API mailkit.filemanager.upload mailkit.filemanager.list mailkit.filemanager.delete
PHP example 1 (Example of mailkit.mailinglist.list call) PHP example 2 (example of mailkit.campaigns.single.schedule call) PERL example of mailkit.mailinglist.adduser call
Search

mailkit.campaigns.list

Function mailkit.campaigns.list returns a list of available campaigns with details about their delivery scheduling and settings.

API call example:

JSON

{  
   "id":"client_id",
   "md5":"client_md5",
   "function":"mailkit.campaigns.list",
   "ID_message":"12345"
}

XML

<?xml version="1.0"?>
<methodCall>
  <methodName>mailkit.campaigns.list</methodName>
  <params>
    <param>
      <value>
        <int>client_id</int>
      </value>
    </param>
    <param>
      <value>
        <string>client_md5</string>
      </value>
    </param>
    <param>
      <value>
        <int>ID_message</int>
      </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. V případě, že vyplníte neplatné ID kampaně, vrátí API prázdnou odpověď.

* required value

Successful call response:

JSON

[
    {
        "NAME": "Name of campaigns",
        "ID_MESSAGE": 12345,
        "SUBJECT": "Campaign subject",
        "SUBJECT_B": "Campaign subject version B",
        "MSG_TYPE": "email",
        "CAMPAIGN_TYPE": "normal",
        "USE_AB": false,
        "TEST_MODE": true,
        "SEND_DATE": "2020-12-31 00:00:01",
        "TIME_ZONE": "Europe/Prague",
        "LAST_SENT": "2020-08-31 14:15:24",
        "REPEAT": false,
        "REPEAT_COUNT": 1,
        "PERIOD": "week",
        "DAYS": "1,3,7"
        "STATUS": "enabled",
        "TYPE": "single",
        "TEST_MODE": false,
        "USER_LIST": [
            123,
            456
        ]
    }
]

XML

<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
  <params>
    <param>
      <value>
        <array>
          <data>
            <value>
              <struct>
                <member>
                  <name>NAME</name>
                  <value>
                    <string>Name of campaign</string>
                  </value>
                </member>
                <member>
                  <name>ID_MESSAGE</name>
                  <value>
                    <i4>12345</i4>
                  </value>
                </member>
                <member>
                  <name>SUBJECT</name>
                  <value>
                    <string>Subject of campaign</string>
                  </value>
                </member>
                <member>
                  <name>SUBJECT_B</name>
                  <value>
                    <string>Subject of campaign</string>
                  </value>
                </member>
                <member>
                  <name>USER_LIST</name>
                  <value>
                    <i4>12345</i4>
                  </value>
                </member>
                <member>
                  <name>LAST_SENT</name>
                  <value>
                    <string>yyyy-mm-dd hh:mm:ss</string>
                  </value>
                </member>
                <member>
                  <name>TYPE</name>
                  <value>
                    <string>single</string>
                  </value>
                </member>
                <member>
                  <name>REPEAT</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>REPEAT_COUNT</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>DAYS</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>TIME_ZONE</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>PERIOD</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>SEND_DATE</name>
                  <value>
                    <string></string>
                  </value>
                </member>
                <member>
                  <name>MSG_TYPE</name>
                  <value>
                    <string>email</string>
                  </value>
                </member>
                <member>
                  <name>CAMPAIGN_TYPE</name>
                  <value>
                    <string>normal</string>
                  </value>
                </member>
                <member>
                  <name>STATUS</name>
                  <value>
                    <string>enabled</string>
                  </value>
                </member>
                <member>
                  <name>TEST_MODE</name>
                  <value>
                    <boolean>FALSE</boolean>
                  </value>
                </member>
                <member>
                  <name>USE_AB</name>
                  <value>
                    <boolean>FALSE</boolean>
                  </value>
                </member>
              </struct>
            </value>
          </data>
        </array>
      </value>
    </param>
  </params>
</methodResponse>

Values

NAME = name of campaign
ID_MESSAGE = ID of campaign
SUBJECT = subject of campaign
SUBJECT_B = campaign B version subject
USER_LIST = ID of mailing list / lists assigned to the campaign. (ID of mailing lists are comma separated)
LAST_SENT = last sent date of campaign. (yyyy-mm-dd hh:mm:ss)
TYPE = type of last campaign's delivery

  • immediate = immediate delivery of campaign
  • single = an unattended delivery of campaign
  • multiple = recurring unattended campaign delivery

REPEAT = can be TRUE in case the campaign is set for recurring delivery
REPEAT_COUNT = the interval of the recurring schedule. Values 1 to x
DAYS = on what days will the campaign delivery occur (when set for recurring campaign delivery). Returns values: 1 - 7 (1= monday, 7= sunday)
TIME_ZONE = time zone (when set for unattended delivery). Possible values: -12:00 (as UTC-12) to 12:00 (as UTC+12)
PERIOD = period of recurring campaign delivery

  • week = weekly
  • month = monthly

SEND_DATE = date of scheduled unattended delivery (yyyy-mm-dd hh:mm:ss)
MSG_TYPE = type of message (email, sms, wpush, apush)
CAMPAIGN_TYPE = type of campaign (normal, remarketing)
STATUS = campaign status (enabled,disabled)
TEST_MODE = whether the campaign is in test mode (true/false)
USE_AB = whether the campaign has A/B testing enabled (true/false)

Contact us

Let us know what your campaign objectives are and we'll create a plan that works for you.

+420 277 001 800
sales@mailkit.com


Processing of information provided using this form is governed by our Privacy Policy.

Required
Required
Required
Mailkit logo

A Czech emailing platform with its own infrastructure, that is a leader in international mailing distribution.

 

  • Features
  • Services
  • Resources
  • About us

services

  • Email Authentication
  • Agency Partnerships
  • Email Training
  • Inbox Brand Visibility
  • Deliverability

ReSOURCES

  • Knowledge Base
  • API documentation
  • Blog
  • Status
  • BIMI inspector
Logo Maawg
Logo Experience
Logo CSA
Logo Signal spam
Logo ISO-27001
Logo ISO-9001
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
© 2006-2022 Mailkit - All rights reserved