Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The MailUpImport web service allows you to load into your MailUp account - using groups and lists - contacts contained in a third party applicationcoming from your database. It also allows you to access sending details and retrieve details about lists, groups and status of import operations, and also to segment the contact database. Among the tasks that you can perform using the MailUpImport Web Service:

...

  • < 0 = error code
  • 0 = call successful
  • > 0 = ID of a message in the MailUp system

Sample ReturnCode

 

Code Block
languagehtml/xml
linenumberstrue
<mailupMessage>
<mailupBody>
<ReturnCode>0</ReturnCode>
...
</mailupBody>
</mailupMessage>

Authentication

...

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

info
Code Block
languagehtml/xml
linenumberstrue
<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>
Image AddedSecurity 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 CodeDescription
-1000unrecognized error
-1001the account is not valid
-1002the password is not valid
-1003suspended account
-1004inactive account
-1005expired account
-1006the web service is not enabled
-1007the web service is not active
-1011IP is not registered
-1012IP 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 CodeDescription
-100unrecognized error
-101verification failed
-102list Guid format is not valid

 

...