Connecting to MailUp

Enabling the MailUp API

This section refers to the SOAP and HTTP API. The REST API uses a different authentication method.

Many CRM, CMS, e-commerce, and other applications communicate with MailUp through the SOAP and/or the HTTP API. For that connection to occur successfully, you will first need to enable the MailUp API in your MailUp account. To do so, follow the steps below.

There are two "areas" of the API that you can separately enable.

  • The "frontend", which for example has to do with allowing an application to subscribe to a new recipient via a form that exists outside of MailUp

  • The "backend", which has to do with importing and exporting data, scheduling mailings, etc. and that is named "MailUpImport" after one of the backend methods

Frontend

Enabling the "Frontend" service is required for MailUp integrations with WordPress, Blogger, and any other integration where there is an HTML form that posts to MailUp (e.g. to add a subscriber to a list).

  1. Log into your MailUp account

  2. Navigate to Settings > Account settings > Developer's corner > Web services

  3. Select Frontend from the drop-down

  4. Check the Enabled checkbox

  5. For added security, enable IP Address Validation and add the IP address of your Web site (even more than one address)

  6. Press "Save"


Locating a Web site's IP address

To find out the IP address of your Web site, you can use a service such as http://websiteipaddress.com or http://www.selfseo.com/find_ip_address_of_a_website.php

Backend (MailUpImport)

Enabling the backend Web services ("MailUpImport" is the name of the main one) is required for MailUp integrations with Drupal, Joomla, Magento, and all other integrations where the external application imports data into MailUp, sets up a mailing, etc.

  1. Log into your MailUp account

  2. Navigate to Settings > Account settings > Developer's corner > Web services

  3. If you access this page for the first time you should also set your password in the "WS Password" data field

  4. Select MailUpImport from the drop-down

  5. Check the Enabled checkbox

  6. For added security, enable IP Address Validation and add the IP address of your Web site (even more than one address)

  7. Press "Save"

Disabling IP address validation

We recommend that you enable IP address validation, for added security, However, there are cases in which you may receive a generic error (e.g. when submitting a form) even after correctly registering the blog or Web site's IP address. If that is the case, please try disabling IP address validation and try again. There are times when IP address validation does not work properly and it can cause this issue. For example, this is the case when the IP address constantly changes (e.g. with certain cloud-based services).

Debugging

The debugging option is mostly for internal purposes. It enables more detailed errors in certain scenarios (e.g. during import). Typically, it should remain unchecked (disabled).