Versions Compared

Key

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

MailUp provides all the tools you need to let a visitor to your Web site or blog subscribe to a specific list using a subscription form. Such forms can be hosted by MailUp or placed directly on your Web pages.

Table of Contents
minLevel2

See the following articles for technical details on how to perform GET/POST request to the MailUp API that allow you to subscribe, update, and unsubscribe recipients.

Child pages (Children Display)

Integrating an existing form with MailUp

A subscription form on the your website can transfer the inserted data to the MailUp account through calls to aspx pages. There are aspx pages that allow to insert, modify, search, and remove contacts in your MailUp distribution list.

The available procedures allow to:

  • Subscribe a user to different lists and groups, using the “Codes table” as a reference (path: Settings > Codes table)
  • Unsubscribe a user from a list;
  • Check user status;
  • Update user’s personal data.

See more technical details on how to perform these operations.

Creating a new subscription form

If you do not have a subscription form available you can create a new one, or use one of the forms provided inside the MailUp console.

Ready-to-use buttons and forms

Subscription buttons and links to predefined forms are available in the MailUp console at the page Settings > Subscription Form. The form’s HTML code can also be copied and pasted on any website (asp, php, etc..): it will work perfectly, as its path is absolute.

Customized forms

Standard forms and buttons are available by selecting Settings > Subscription Form in the MailUp admin console. You can copy and paste them, and then freely customize them, as calls have an absolute path to the form handler. This way, it is very simple to create new forms for special scenarios such as events or meetings, without any particular programming skills. All the variables to be passed (name=list, group, campo1, campo2…) can be of any type (type=checkbox, text, radio, button) and can assume any value. Two procedures can be used to develop these forms:

 

Info
titleWhat's a "campo"?
The field code uses the word "CAMPO" because MailUp's original source code was developed in Italy. "Campo" means "Field" in Italian (smile)

 

About using MailUp's subscription forms

A few notes about using the subscription forms that exist in your MailUp account.

...

Creating a new subscription form

MailUp form builder

MailUp contains a handy drag-&-drop form builder that allows you to easily and quickly create responsive layout subscription forms. You can either have MailUp host the forms, or copy and paste the code onto your Web site. 

For details, please see: List building tools

A few notes:

  • Once the form has been submitted, the messages page will be displayed. This page is fully customizable in your MailUp account at Settings > List settings > Landing pages 
  • As an alternative, you can specify a different URL on your website that your customers will be redirected to in different cases (subscription completed, duplicate email address, and so on).
  • Note that the domain that hosts the messages page (and any other page hosted by MailUp) can be hidden using a third level domain (CNAME: e.g. news.yourCompany.com).
  • MailUp uses Confirmed Opt-in by default (also called double opt-in). Once the form has been filled out, an option in the MailUp console allows to send an email to the user asking to confirm his email will be sent asking the new recipient to confirm her subscription by clicking into a link. The content and the sender of this email can be customized at the page Settings under Settings > List settings > Notifications > Confirmation request.
  • Users who confirm their subscription then receive a confirmation Welcome email, which can be personalized as well .under Settings > List settings > Notifications > Welcome
  • You can subscribe a user someone to more than a list at the same time, while sending just one subscription confirmation request.

...

Using your forms

Of course, you can adapt existing forms so that they correctly communicate with MailUp. See more technical details on how to do so.

You can also leverage the REST or SOAP APIs to accomplish the same tasks (e.g. subscribing new recipients).


Info
titleWhat's a "campo"?
The field code uses the word "CAMPO" because MailUp's original source code was developed in Italy. "Campo" means "Field" in Italian (smile)