MailUpService 1.1

Version 1.1 of MailUp web services uses a different hostname than v. 1.0 and it has the following features:

Two new methods (marked with symbol) to retrieve available lists for a MailUp console and available email messages for a specified list
New methods support JSONP in order to allow cross domain requests (with HTTP GET)
Full support of v. 1.0 methods

Endpoints

SOAP: https://services.mailup.com/1.1/MailUpService.svc

REST: https://services.mailup.com/1.1/MailUpService.svc/rest

JSONP: https://services.mailup.com/1.1/MailUpService.svc/jsonp

Methods

Group	Description	Available methods
Authentication	Login and logout methods. Login returns an access key that can be used as parameter when calling other methods	AuthenticationLogin AuthenticationLogout
Filters	Create and delete MailUp filters.	FiltersCreatePersonalDataFilter FiltersDeletePersonalDataFilter FiltersCreateActivityFilter FiltersDeleteActivityFilter FiltersCreateGeographicFilter FiltersDeleteGeographicFilter
Test	This group includes methods that can be used to test the service	Ping
Emails	This group includes methods that manage email messages	EmailsRead
Lists	This group allows lists management	ListsRead

Using SOAP

As specified in WSDL, SOAP methods receives a specific "request" object as input parameter and return a specific "response" object. Please refer to the description of each method for more details.

Error Handling

In case of error a standard SOAP Fault object is returned (more on this)

Using REST

REST is supported only when XML parameters are passed with http POST method (Ping method is the only exception, which can be called using http GET https://services.mailup.com/1.1/MailUpService.svc/rest/Ping).
Required parameter format is the same as what is specified for SOAP requests (see example below).

Restrictions

Available REST methods cannot be called using HTTP GET ("Ping" test method is the only exception, which can be called using http GET https://services.mailup.com/1.1/MailUpService.svc/rest/Ping)
If you are experiencing some "cross domain problems" (i.e. you're unable to request data from a server in a different domain) you can try JSONP (available only for a subset of v.1.1 methods)

Configuration

Please refer to REST configuration page to get some tips about enabling REST

Example

Please refer to examples provided for v. 1.0 (link).

Using JSONP

Each request is done using HTTP GET and the following format:

https://services.mailup.com/1.1/MailUpService.svc/jsonp/MethodName?parameter1=value1&parameter2=value2

Due to security concerns, JSONP is available only for a subset of methods (see table below)

JSONP method	parameters	notes
ListsRead	token idList	Returns available lists, similar to MailUpSend.GetLists
EmailsRead	token	Returns available email messages for specified list, skipping cloned messages. Provides the same reusult as MailUpSend.CloneMessages

Example

A detailed example is provided at this page: link