Overview | Technical 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. | 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. |
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:
- Using forms: technical details
- Get/Post API ExampleGet/Post API ExampleGet/Post requests
- Web Service (WS_MailupImport).
What's a "campo"?
![(smile)](/wiki/s/-1537254593/6452/a0a612059653edc6bf5ec4eeefe0f162fca18a67/_/images/icons/emoticons/smile.png)
About using MailUp's subscription forms
A few notes about using the subscription forms that exist in your MailUp account.
- You may modify these forms with any HTML editor and place their source code on your website, with the freedom to modify the number of fields and the format (dropdown, plain text, checkbox, radiobutton).
- The form action uses an absolute path to the form handler hosted by MailUp, so it will work after being copied and pasted to another location
- Your MailUp admin console allows to create subscription forms that can be inserted on any website regardless of the OS (Linux, Windows..) and of the language. Simple JavaScript validation on the validity of the provided email address is included.
- Several subscription forms are available in the MailUp admin console, and they can be freely used and published. To activate or disable them, go to the page Settings > Edit lists in the console. In order to have a standard form to subscribe a user to a list and to a group by providing the email address only, with integrated check on Javascript, please see Settings > Subscription Form in the MailUp console.
- You can also use the MailUp API to create subscription forms using Flash.
- Once the form has been filled out, the messages page - freely customizable at Settings > Messages Page - will open. 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).
- 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 subscription by clicking into a link. The content and the sender of this email can be customized at the page Settings > Confirmation request.
- Users who confirm their subscription then receive a confirmation email, which can be personalized as well.
- You can subscribe a user to more than a list at the same time, sending just one confirmation request.
For more information and "how to's" on using subscription forms (and related settings) in MailUp, please see these articles MailUp Knowledge Base.