Table of Contents
Table of Contents |
---|
Overview
This The MailUpImport web service allows you to map in load into your MailUp account - using groups and lists - the recipients contacts contained in a third party application, and . It also allows the external system you to access the sending details of MailUp mailings. So MailUp can handle the segmentation of recipients already existent in the third party system, as well as sendings to recipients subscribed to multiple lists.sending details and segment the contact database. Among the tasks that you can perform using the MailUpImport Web Service:
- Get all the distribution Lists and the Groups they contain;
- Create a new Group within an existing List;
- Upload a list of subscribers in order to create a new import process;
- Get import process status;
- Start import process.
Each method returns a XML string containing a "MailUp Message", which includes a "ReturnCode" and the requested information (when available).
The ReturnCode is a number, with the following values:
- < 0 = error code
- 0 = call successful
- > 0 = ID of a message in the MailUp system
Sample ReturnCode
Code Block | ||||
---|---|---|---|---|
| ||||
<mailupMessage>
<mailupBody>
<ReturnCode>0</ReturnCode>
...
</mailupBody>
</mailupMessage> |
Authentication
WS_MailUpImport checks the following parameters in order to authenticate requests:
...
*different from the credentials used to access the console
Authentication fails if:
- MailUp API is offdisabled in your MailUp account;
- username and/or password are incorrect;
- the IP address of the third party application has changed since the last successful access. The IP address can be manually changed in the MailUp console.
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 cryptographic |
encrypted |
Error codes
ReturnCode possible 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
MailUp API status
Once the API account has been created, the MailUp APIs must be activated in order to be able to receive requests (they are disabled by default for safety reasons): they can be activated manually using the MailUp admin console or automatically by calling a specific URL.
Disactivation Deactivation is also manual done manually through the MailUp console.
The The IP address of the application using the web service is registered at activation stage.
To manually activate and configure the MailUp API in your MailUp admin console:
- Log into your account
- Navigate to Manage > Web Services
- Select WSMailUpImport from the drop-down at the top
- Make sure they are enabled and that the necessary IP addresses have been added to allow for requests coming from there
Note about Data Fields
Note |
---|
The WS_MailUpImport methods support up to 20 personal data fields. Should it be necessary to import more than 20 fields, there are other procedures that can be used. |
...
For example:
|