Page Comparison

...

• string CreateList(string accessKey, string name, string defaultSettings, bool copyTemplate, Option[] options)
  • accessKey: access key obtained using the Login method
  • name: list name
  • defaultSettings: if set as "default" it uses the default settings for all the lists, if it is an ID it uses the default settings for the corresponding list
  • copyTemplate: if set as "true" it copies the default templates for the list
  • options: array of values for options setting
    • owneremail: sender email address
    • bouncedemail: address for error messages
    • description: list description
    • format: list format ("html", "text")
    • charset: text charset (see a list of /wiki/spaces/mailupapi/pages/36339743)
    • public: flag indicating if the list is visible in the frontend
    • tracking: flag enabling the tracking of opens
    • nl_sendername: emali sender name
    • sms_sendername: sms sender name
    • optout_type: optout type (1: Single with confirmation, 2: Single, 3: Double)
    • sendemailoptout: flag indicating if an email is sent to unsubscribers
    • notifyemail: notification email sent to the administrator in case of unsubscriptions
    • frontendform: flag that allows to view the subscription forms in the frontend
    • disclaimer: heading added to the messages in the list
    • headerxabuse: heading added to the messages in the list
    • kbmax: message size beyond which a warning is generated
    • replyto: email address for replies to the newsletter
    • displayas: name displayed in the "To:" field of the incoming newsletters (campo1,campo2, etc.)
    • headerlistunsubscriber: heading added to the messages in the list
    • multipart_text: flag to automatically generate a text version of the message at sending stage
    • conversionlab_trackcode: code for tracking via conversionlab
    • default_prefix: default international prefix for mobile numbers
    • multi_optout_list: detail of the lists which will be viewed by the user in case of multiple optout (e.g. 1,2,3 etc.)
    • subscribedemail: flag to send an email to new subscribers
    • sendconfirmsms: flag to send a text message to new subscribers
    • senderfaxname: fax sender name
    • senderfax: fax sender number
    • senderfirstname: regular mail sender name
    • senderlastname: regular mail sender surname
    • sendercompanyname: regular mail sender company
    • senderaddress: regular mail sender address
    • senderpostalcode: regular mail sender zipcode
    • sendercity: regular mail sender city
    • senderprovince: regular mail sender province
    • senderstate: regular mail sender state

...

<InsertListResult>
<errorCode>0</errorCode>
<errorDescription></errorDescription> 
<list>
<listID>1</listID>
<listName>Demo</listName>
<hash></hash>
<name></name>
<description></description>
<format></format>
<charset></charset>
<public></public>
<tracking></tracking>
<unsubscribe></unsubscribe>
<owneremail></owneremail>
<bounceemail></bounceemail>
<header></header>
<footer></footer>
<footercustom></footercustom>
<footermailup></footermailup>
<nl_sendername></nl_sendername>
<sms_sendername></sms_sendername>
<optout_type></optout_type>
<sendemailoptout></sendemailoptout>
<notifyemail></notifyemail>
<frontendform></frontendform>
<disclaimer></disclaimer>
<headerxabuse></headerxabuse>
...
...
</list>
</InsertListResult> 

Code Examples

# Refer to https://mailup.atlassian.net/wiki/display/mailupapi/MailUp+RubyGem for gem information.
require 'mailup'
m = MailUp::Manage.new('api-username', 'api-password')
m.create_list(:name            => "List Name",
              :defaultSettings => "default",
              :copyTemplate    => true,
              :options         => {
                "OwnerEmail"   => "owner@email.com",
                "BouncedEmail" => "bounced@email.com",
                ...
              })
# Returns XML response
# => "<InsertListResult><errorCode>0</errorCode><errorDescription></errorDescription><list> ... </list></InsertListResult>"