Versions Compared

Key

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

...

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:

  • Several consecutive calls until all the fields are imported;
  • Batch import from file;
  • Synchronized import from file, using the MailUpSend.SendNewsletterNL web service.

API registration and activation

WS_MailUpImport can be used only after configuring the IP address of the caller. This can be made through the MailUp console or by calling a specific activation method.
The username and password defined for the API account, used to call the web services, are different from those used to access the MailUp console.

Activation via the "Manage" page in the MailUp console

From the menu on the left of the screen in the administration console, select Manage > Web services. The page presents itself as shown in the image below. Inserting an IP address allows to call WS_MailUpImport methods from that very address. All the administration consoles are created with specific username and password for web services: this page also allows to change the password or disable the account.

Image Removed

Activation via call to an URL

A third party application can enable web services via a call to

...

  • usr: MailUp API Account username (e.g. a7132)
  • pwd: MailUp API Account password
  • nl_url: Console URL (e.g abcd.sp09.com, omitting "http://" )
  • ws_name: Web service name (specify: "WSMailUpImport")

...

Sample WSActivation response

Code Block
languagehtml/xml
linenumberstrue
<mailupMessage>
<mailupBody>
<ReturnCode>0</ReturnCode>
<WS_Activation>
<WS_Name> WS_MailUpImport </WS_Name>
<DateOfRequest>2008-01-16</DateOfRequest>
<User>admin</User>
</WS_Activation>
</mailupBody>
</mailupMessage >

 

ReturnCodes

CodeDescription
0request execution succeeded
-2ws name has not been specified (1)
-4user name has not been specified (1)
-8password has not been specified (1)
-16nl url has not been specified (1)
-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
-1008the web service is already active
-1009web service activation error
-1010IP registration error

...