...
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 credentials passed in the authentication request 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/WSMailupWSMailupImport.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
...