...
...
...
This method creates a MailUp list
Method parameters
Creates a list
- string CreateList(string accessKey, string name, string defaultSettings, bool copyTemplate, Option[] options)
- accessKey: access key obtained using the LoginLoginFromId 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 (if you set public=1 the created list will be available in http://consoleUrl/frontend/nl_catalog.aspx)
- tracking: flag enabling the tracking of opens (1=enabled)
- nl_sendername: emali email sender name (text string)
- sms_sendername: sms sender name (text string)
- optout_type: optout type (1: Single with confirmation, 2: Single, 3: Double0: One-click unsubscribe, 1: , 2: )
- sendemailoptout: flag indicating if an email is sent to unsubscribers
- notifyemail: notification email sent to the administrator in case of unsubscriptionsemail address for unsubscribe notifications. Each time a recipient unsubscribes, an email will be sent to this address.
- 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
...
Info |
---|
IMPORTANT:
|
Note | ||
---|---|---|
| ||
|
SOAP Examples
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://services.mailupnet.it/WS">
<soapenv:Header/>
<soapenv:Body>
<ws:CreateList>
<ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9S8EyQZb6ZE2s</ws:accessKey>
<ws:name>My new list</ws:name>
<ws:defaultSettings>default</ws:defaultSettings>
<ws:copyTemplate>true</ws:copyTemplate>
<ws:options>
<ws:Option><ws:Key>OwnerEmail</ws:Key> <ws:Value>john@example.com</ws:Value></ws:Option>
<ws:Option><ws:Key>nl_sendername</ws:Key> <ws:Value>John Smith</ws:Value></ws:Option>
<ws:Option><ws:Key>optout_type</ws:Key> <ws:Value>2</ws:Value></ws:Option>
<ws:Option><ws:Key>multi_optout_list</ws:Key> <ws:Value>0,1,2,19</ws:Value></ws:Option>
<ws:Option><ws:Key>public</ws:Key> <ws:Value>1</ws:Value></ws:Option>
<ws:Option><ws:Key>tracking</ws:Key> <ws:Value>1</ws:Value></ws:Option>
<ws:Option><ws:Key>charset</ws:Key> <ws:Value>ISO-8859-1</ws:Value></ws:Option>
</ws:options>
</ws:CreateList>
</soapenv:Body>
</soapenv:Envelope> |
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<InsertListResult> <errorCode>0</errorCode> <errorDescription></errorDescription> <list> <listID>1< <listID>26</listID> <listName>Demo</listName> <hash>< <hash>173a6e95-0000-439a-0000-000000000000</hash> <name>< <name>My new list</name> <description></description> <format><<format>html</format> <charset>< <charset>ISO-8859-1</charset> <public>< <public>True</public> <tracking>< <tracking>True</tracking> <unsubscribe></unsubscribe> <owneremail>< <owneremail>john@example.com</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> <bounceemail>a1234@a1234.r00.it</bounceemail> <header> <![CDATA[<div style="font-size: 11px;" align="center"><font color="#c0c0c0" face="Verdana, Arial, Helvetica, sans-serif"><a href="http://[staticnl]/" name="showInBrowser"> </a><div style="font-size: 11px;" align="center"><a href="http://[staticnl]/" name="showInBrowser"></a><font color="#c0c0c0" face="Verdana, Arial, Helvetica, sans-serif"><a href="http://[staticnl]/" name="showInBrowser"><font color="#c0c0c0">Se non legge correttamente questo messaggio, cliccare qui</font></a> </font></div></font></div><br>]]]> > <![CDATA[</header><footer><![CDATA[<div style="FONT-SIZE: 11px" align=center><font face="Verdana, Arial, Helvetica, sans-serif" color=#c0c0c0><a href="http://[unsubscribe]/" target=_blank><strong><font color=#808080><br>Per cancellarsi cliccare qui | Unsubscribe</font></strong></a> </font></div><br><br> <div style="FONT-SIZE: 11px" align=center><a href="http://master.mailupnet.it/r" target=_blank><font color=#808080><img title=MailUp style="WIDTH: 53px; HEIGHT: 20px" height=20 alt=MailUp src="http://a0h3b.s10.it/images/Modelli/MailUp-logo.gif" width=53 align=absMiddle border=0></font></a><font color=#808080><font face="Verdana, Arial, Helvetica, sans-serif"> Email inviata con <a href="http://master.mailupnet.it/r" target=_blank name=""><font color=#808080>MailUp</font></a></font></font><font color=#808080><font face="Verdana, Arial, Helvetica, sans-serif"><a href="http://master.mailupnet.it/r" target=_blank><font color=#808080><br></font></a><a title="Chi usa MailUp per inviare, utilizza uno strumento che garantisce la cancellazione automatica e immediata" href="http://master.mailupnet.it/p" target=_blank name=""><font color=#808080>Con MailUp la cancellazione e' sicura</font></a></font></font></div>]]]> > <![CDATA[</footer><footercustom><![CDATA[]]]> > <![CDATA[</footercustom><footermailup><![CDATA[<div style="FONT-SIZE: 11px" align=center><font face="Verdana, Arial, Helvetica, sans-serif" color=#c0c0c0><a href="http://[unsubscribe]/" target=_blank><strong><font color=#808080><br>Per cancellarsi cliccare qui | Unsubscribe</font></strong></a> </font></div><br><br> <div style="FONT-SIZE: 11px" align=center><a href="http://master.mailupnet.it/r" target=_blank><font color=#808080><img title=MailUp style="WIDTH: 53px; HEIGHT: 20px" height=20 alt=MailUp src="http://a0h3b.s10.it/images/Modelli/MailUp-logo.gif" width=53 align=absMiddle border=0></font></a><font color=#808080><font face="Verdana, Arial, Helvetica, sans-serif"> Email inviata con <a href="http://master.mailupnet.it/r" target=_blank name=""><font color=#808080>MailUp</font></a></font></font><font color=#808080><font face="Verdana, Arial, Helvetica, sans-serif"><a href="http://master.mailupnet.it/r" target=_blank><font color=#808080><br></font></a><a title="Chi usa MailUp per inviare, utilizza uno strumento che garantisce la cancellazione automatica e immediata" href="http://master.mailupnet.it/p" target=_blank name=""><font color=#808080>Con MailUp la cancellazione e' sicura</font></a></font></font></div>]]]> > <![CDATA[</footermailup><nl_sendername>John Smith</nl_sendername><sms_sendername></sms_sendername><optout_type>2</optout_type><sendemailoptout>False</sendemailoptout><notifyemail></notifyemail><frontendform>True</frontendform><disclaimer><![CDATA[Privacy Protected with <a href="http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp" target=_blank>Safely Subscribe System</a>]]]> > <![CDATA[</disclaimer><headerxabuse><![CDATA[Please report abuse here: http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp]]]> > <![CDATA[</headerxabuse><headersender><![CDATA[Please report abuse here: http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp]]]> > <![CDATA[</headersender><kbmax>0</kbmax><headerreplyto><![CDATA[mary@example.com]]]> > <![CDATA[</headerreplyto><displayas></displayas><headerlistunsubscribe><![CDATA[http://[unsubscribe]/]]]> > <![CDATA[</headerlistunsubscribe><smtp_confirm>smtpcr.mailupnet.it</smtp_confirm><multipart_text>False</multipart_text><conversionlab_trackcode><![CDATA[]]]> ></header> </list> </InsertListResult> |
Code Examples
Code Block | ||||
---|---|---|---|---|
| ||||
# 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>" |