Table of Contents
Table of Contents |
---|
Child pages (Children Display) | ||
---|---|---|
|
Overview
The MailUpImport web service allows you to load into your MailUp account - using groups and lists - contacts contained in a third party application. It also allows you to access sending details and segment the contact database. Among the tasks that you can perform using the MailUpImport Web Service:
...
The WS_MailUpImport web service requires for every call an authentication via username and password; credentials must be passed in the header of the SOAP message.
Sample MailUpImport authentication
Code Block | ||||
---|---|---|---|---|
| ||||
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header> <Authentication xmlns="http://tempuri.org/"> <User>username</User> <Password>password</Password> </Authentication> </soap:Header> <soap:Body> ... </soap:Body> </soap:Envelope> |
Info |
---|
Security warning: in the current release of the system the passed credentials are not encrypted |
Error codes
ReturnCode values in case authentication fails are shown below:
Error Code | Description |
---|---|
-1000 | unrecognized error |
-1001 | the account is not valid |
-1002 | the password is not valid |
-1003 | suspended account |
-1004 | inactive account |
-1005 | expired account |
-1006 | the web service is not enabled |
-1007 | the web service is not active |
-1011 | IP is not registered |
-1012 | IP is registered but has the "deny access" flag |
All the methods requiring idList e listGuid at input, execute a check on the input values and return one of the following:
Error Code | Description |
---|---|
-100 | unrecognized error |
-101 | verification failed |
-102 | list Guid format is not valid |
Glossary
- MailUp customer: a company/business subscribing to the MailUp service
- Console URL / NL_URL: MailUp defines a dedicated URL for each Customer. For this reason, external systems must know the exact URL to which to send the request (e.g. http://mailing.myCompany.com/Services/WSMailup.asmx). You can use a custom URL if your account has the Private Labeling feature turned on.
- WS_MailUpImport: a Web Service designed to import recipients from a third party application
- MailUp API Account: credentials used specifically with the MailUp API, different from the credentials used to log into your MailUp account. They consist of a username and a password. The API account credentials are automatically created when a new MailUp account is created for a new customer, while for existing customers they are manually created via the MailUp console.
- WS: Web Service
...