Page Comparison

On this page:

...

Description

Create a new list

HTTP Method

POST

URL

https://services.mailup.com/API/v1.1/Rest/ConsoleService.svc/Console/List

Reference

Go to automated doc

JSON request (example)

Inherit missing values from a specified list (i.e., list identifier equals to 14)

Expand

Code Block

{
  "Name": "New Arrivals",
  "Business": true,
  "Customer": true,
  "OwnerEmail": "jane@example.com",
  "ReplyTo": "mike@example.com",
  "DisplayAs": "Your sender name",
  "NLSenderName": "Your list name",
  "CompanyName": "Your company",
  "ContactName": "Your name",
  "Address": "Your address",
  "City": "Your city", 
  "CountryCode": "IT",
  "PermissionReminder": "Your permission reminder",
  "WebSiteUrl": "www.mailup.it",
  "Description": "",
  "Phone": "",
  "PostalCode": "",
  "StateOrProvince": "",
  "TimeZoneCode": "UTC+01:00.0",
  "SmsSenderName": "",
  "DefaultPrefix": "0039",
  "SendConfirmSms": false,
  "Charset": "UTF-8",
  "Format": "html",
  "MultipartText": true,
  "KBMax": 100,
  "NotifyEmail": "",
  "OptoutType": 3,
  "MultiOptoutList": "19",
  "SendEmailOptout": false,
  "SubscribedEmail": true,
  "BouncedEmail": null,
  "FrontendForm": true,
  "Public": true,
  "ScopeCode": 0,
  "TrackOnOpened": true
  "ConversionlabTrackCode": "",
  "LinkTrackingParameters": "",
  "Disclaimer": "Per l'informativa sulla privacy D.Lgs 196/2003 visitare l'home page del sito. <br/> Policy AntiSPAM garantita da <a href=\"http://www.mailup.it/email-marketing/policy-antispam.asp\" target=_blank><img src=\"http://doc.mailupnet.it/logo_small_R.gif\" border=\"0\" align=\"middle\" /></a>",
  "HeaderListUnsubscriber": "<[listunsubscribe]>,<[mailto_uns]>",
  "HeaderXAbuse": "Please report abuse here:  http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp",
  "IdSettings": 14
}

Inherit missing values from default settings. they are the values used to create the first list (with identifier equals to 1)

Expand

Code Block

{
  "Name": "New Arrivals",
  "Business": true,
  "Customer": true,
  "OwnerEmail": "jane@example.com",
  "ReplyTo": "mike@example.com",
  "DisplayAs": "Your sender name",
  "NLSenderName": "Your list name",
  "CompanyName": "Your company",
  "ContactName": "Your name",
  "Address": "Your address",
  "City": "Your city", 
  "CountryCode": "IT",
  "PermissionReminder": "Your permission reminder",
  "WebSiteUrl": "www.mailup.it",
  "Description": "",
  "Phone": "",
  "PostalCode": "",
  "StateOrProvince": "",
  "TimeZoneCode": "UTC+01:00.0",
  "SmsSenderName": "",
  "DefaultPrefix": "0039",
  "SendConfirmSms": false,
  "Charset": "UTF-8",
  "Format": "html",
  "MultipartText": true,
  "KBMax": 100,
  "NotifyEmail": "",
  "OptoutType": 3,
  "MultiOptoutList": "19",
  "SendEmailOptout": false,
  "SubscribedEmail": true,
  "BouncedEmail": null,
  "FrontendForm": true,
  "Public": true,
  "ScopeCode": 0,
  "TrackOnOpened": true
  "ConversionlabTrackCode": "",
  "LinkTrackingParameters": "",
  "Disclaimer": "Per l'informativa sulla privacy D.Lgs 196/2003 visitare l'home page del sito. <br/> Policy AntiSPAM garantita da <a href=\"http://www.mailup.it/email-marketing/policy-antispam.asp\" target=_blank><img src=\"http://doc.mailupnet.it/logo_small_R.gif\" border=\"0\" align=\"middle\" /></a>",
  "HeaderListUnsubscriber": "<[listunsubscribe]>,<[mailto_uns]>",
  "HeaderXAbuse": "Please report abuse here:  http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp",
  "UseDefaultSettings": true
}

JSON response (example)

Expand

Code Block

language	js

{
  "IdList": 19,
  "ListGuid": "57f9c675-63d6-498f-91b6-7f60f9f30b2e",
  "Name": "New Arrivals",
  "Description": "",
  "NLSenderName": "Your list name",
  "OwnerEmail": "jane@example.com",
  "PermissionReminder": "Your permission reminder",
  "Address": "Your address",
  "Business": true,
  "City": "Your city",
  "CompanyName": "Your company",
  "ContactName": "Your name",
  "CountryCode": "IT",
  "Customer": true,
  "DisplayAs": "Your sender name",
  "Phone": "",
  "PostalCode": "",
  "ReplyTo": "mike@example.com",
  "StateOrProvince": "",
  "WebSiteUrl": "www.mailup.it"
  "BouncedEmail": null,
  "Charset": "UTF-8",
  "ConversionlabTrackCode": "",
  "DefaultPrefix": "0039",
  "Disclaimer": "Per l'informativa sulla privacy D.Lgs 196/2003 visitare l'home page del sito. <br/> Policy AntiSPAM garantita da <a href=\"http://www.mailup.it/email-marketing/policy-antispam.asp\" target=_blank><img src=\"http://doc.mailupnet.it/logo_small_R.gif\" border=\"0\" align=\"middle\" /></a>",
  "Format": "html",
  "FrontendForm": true,
  "HeaderListUnsubscriber": "<[listunsubscribe]>,<[mailto_uns]>",
  "HeaderXAbuse": "Please report abuse here:  http://www.mailup.it/email-marketing/Policy-antispam_ENG.asp",
  "KBMax": 100,
  "LinkTrackingParameters": "",
  "MultiOptoutList": "19",
  "MultipartText": true,
  "NotifyEmail": "",
  "OptoutType": 3,
  "Public": true,
  "ScopeCode": 0,
  "SendConfirmSms": false,
  "SendEmailOptout": false,
  "SmsSenderName": "",
  "SubscribedEmail": true,
  "TimeZoneCode": "UTC+01:00.0",
  "TrackOnOpened": true
}

Paging and filtering (example)

Old "create list" method
Anchor
deprecatedcreatelist
deprecatedcreatelist

Expand

title	DEPRECATED - Old method to create for creating a new list

Note
MailUp copies data from the mandatory information fields of the list you are specifying as a reference, list 1 is used when 'useDefaultSettings=true'. This method fails returning a HTTP 500 error when the mandatory information fields to be copied are empty.

Description

Create a new list

HTTP Method

POST

URL

https://services.mailup.com/API/v1.1/Rest/ConsoleService.svc/Console/User/Lists

Reference

Go to automated doc

Expand

title	Click here to learn more about request parameters

Mandatory fields are marked in bold. To have an example of data formats you can have a look at the response of "Update List" method

Field name	Type	Description
bouncedemail	String	Address for error messages
charset	String	Text charset (see a list of Supported Charsets)
conversionlab_trackcode	String	Code for tracking via conversionlab
default_prefix	String	Default international prefix for mobile numbers (e.g. "0039" for Italy and "001" for United States)
description	String	Additional details about what the list is used for.
disclaimer	String	Heading added to the messages in the list
displayas	String	This is the name that will be displayed in the "To" section of the e-mail message heading. Name can be customized with dynamic fields using "campoN" labels (e.g. campo1,campo2, etc.), where N is the progressive number of the dynamic field
format	String	Format of emails to be sent with this list ("html" or "text")
frontendform	Boolean	Enable hosted subscription forms, which you can view and edit under Settings > List settings > List Building Tools.
headerlistunsubscriber	String	Heading "LIST-UNSUBSCRIBE" added to the messages in the list. Suggested value = "<[listunsubscribe]>,<[mailto_uns]>"
headerxabuse	String	Heading "X-ABUSE" added to the messages in the list. Suggested value = "Please report abuse here: http://[host]/p"
kbmax	Integer	Message size beyond which a warning is generated. Suggested value = 100
multi_optout_list	String	Detail of the list IDs which will be viewed by the user in case of multiple optout (e.g. 1,2,3 etc.). Applies only when optout_type=2
multipart_text	Boolean	Flag to automatically generate a text version of the message at sending stage
nl_sendername	String	Email sender name: the person or entity that is sending the message. It could simply be your company name.
notifyemail	String	Email address for unsubscribe notifications. Each time a recipient unsubscribes, an email will be sent to this address.
optout_type	Integer	Optout settings that apply when a recipient unsubscribe (0: One-click unsubscribe, 1: Confirmed unsubscribe, 2: Confirmed unsubscribe with list preferences, 3: Confirmed unsubscribe with options, 4: Confirmed unsubscribe with Preference Center)
owneremail	String	"FROM" email: the email address that is sending the message. Make sure that it is a recognizable address (e.g. it uses your Web site domain). For security reason, please trust this email address, as explain by the method Trust an email address.
public	Boolean	Flag indicating if the list is visible in the public web library (if you set public=true the created list will be available in http://consoleUrl/frontend/nl_catalog.aspx)
replyto	String	If your newsletter asks for a reply from the recipients, you may want the replies to be sent to a different address from the "FROM" email. Enter the reply-to address here: it must be a valid email address. If you leave the field blank, the "FROM" address (see "owneremail" field) will be used. For security reason, please trust this email address, as explain by the method Trust an email address.
sendconfirmsms	Boolean	True when welcome SMS has to be sent for any new subscriber on SMS channel
sendemailoptout	Boolean	When true a "goodbye email" is sent to recipient that unsubscribe
senderfax	String	Deprecated field, do not use it
senderfaxname	String	Deprecated field, do not use it
sms_sendername	String	Default sender name for text messages. It can be a phone number (e.g. +393351234567) or a string (up to 11 chars, only letters and number). Please note that in some country, like Italy, some restrictions on SMS senders apply. Use MailUp admin console to verify if the specified sender is subject to limitations in some countries.
subscribedemail	Boolean	True when welcome email has to be sent for any new subscriber (it works only when double optin is implemented)
tracking	Boolean	True when link tracking has to be enabled at list level
Customer	Boolean	True if your mailing is directed to consumers
Name	String	List name (max 50 characters)
business	Boolean	True if your mailing is directed to businesses
copyTemplate	Boolean	Deprecated field. Always use "false" value
copyWebhooks	Boolean	When true and an existing list is set as template, then webhooks configuration is copied from that list
idSettings	Integer	ID of an existing list to be used as template. This field is ignored when 'useDefaultSettings=true'
scope	String	select here which type of messages you are sending from this list: "newsletters" (default), "Direct_Advertising" (promotions, direct marketing messages), or "Transactional" (transactional messages like alerts, reminders, notifications)
useDefaultSettings	Boolean	When false, an existing list, specified by 'idSettings' field, is used as template. Otherwise default settings are used
CompanyName	String	The name of the company that is responsible for the messages sent out form this list. This field and the others that follows should be included as "sender information" in each message sent. Please refer to this page for more details
ContactName	String	The contact reference name
Address	String	The company's address
City	String	The company's city
PostalCode	String	The company's postal code
StateOrProvince	String	The company's state or province
CountryCode	String	The company's country. Please use one of the Country codes provided by the method Get List of Country codes.
Phone	String	The company's phone number
WebSiteUrl	String	The company's web site url
PermissionReminder	String	Use this field to remind recipients of why they are receiving messages. For example, you can use a message like this: You are receiving this message because you registered on our Web site and agreed to receive email communication from us.

JSON request (example)

Expand

Code Block

{
   "Name":"New Arrivals",
   "useDefaultSettings":false,
   "idSettings":1,
   "business":true,
   "Customer":true,
   "scope":"newsletters",
   "owneremail":"jane@example.com",
   "format":"html",
   "copyTemplate":true,
   "copyWebhooks":true,
   "charset":"UTF-8",
   "public":true,
   "tracking":true,
   "optout_type":0,
   "sendemailoptout":false,
   "frontendform":true,
   "headerxabuse":"Please report abuse here: http://[host]/p",
   "kbmax":100,
   "replyto":"mike@example.com",
   "headerlistunsubscriber":"<[listunsubscribe]>,<[mailto_uns]>",
   "multipart_text":true,
   "subscribedemail":true,
   "sendconfirmsms":false,
   "CompanyName":"Your company",
   "ContactName":"Your name",
   "Address":"Your address",
   "City":"Your city",
   "PostalCode":"26100",
   "StateOrProvince":"Cremona",
   "CountryCode":"IT",
   "PermissionReminder":"Your permission reminder",
   "WebSiteUrl":"Your site",
   "Phone":"Your phone number",
}

JSON response (example)

List ID (e.g. 18)

Paging and filtering (example)

...

add and subscribe one or more recipients. See "Import recipients".
force subscription of an existing recipient (i.e. unsubscribed or pending) by specifiying its ID. Refer to "Update subscription"

Remove recipients from a list - unsubscribe

...

Versions Compared

Old Version 57

New Version 58

Key

Old "create list" method
Anchor
deprecatedcreatelist
deprecatedcreatelist

Remove recipients from a list - unsubscribe

Page Comparison

Versions Compared

Old Version 57

New Version 58

Key

Old "create list" method Anchordeprecatedcreatelistdeprecatedcreatelist

Remove recipients from a list - unsubscribe

Old "create list" method
Anchor
deprecatedcreatelist
deprecatedcreatelist