Overview
...
...
...
...
...
...
...
...
Table of Contents |
---|
Subscribe.aspx
...
...
...
...
...
...
Info | ||
---|---|---|
| ||
In case a user subscribes to more than one list, the system will still only send one confirmation request message, which will allow the user to confirm their subscription to all the lists included in the signup request. Note that the system will use the message templates (e.g. subscription confirmation request message and subscription confirmation message), as well as the Web page templates defined for the first List that the user was subscribed to. |
The “value” field must contain the ID of the list the user will be subscribed to. You can see that numeric value shown in the MailUp admin console under Settings > Edit lists or looking at the dropdown menu at the top left of the page. In the image, the list called "New products" has value=3.
Mobile phone number (optional)
You can use the mobile number field to record the customer's mobile number in the database and be able to send text messages to them.
Code Block | ||
---|---|---|
| ||
<input id="prefix" value="001" type="text" name="prefix" />
<input id="sms" type="text" name="number" /> |
Please note that the field “prefix” (international prefix) needs not be entered as a separate field, it can also be inserted in the field “number”. We recommend passing it as a separate field for clarity’s sake.
Groups (optional)
You can optionally present the user with a choice of one or more groups.
Code Block | ||
---|---|---|
| ||
<input name="group" type="checkbox" value="1"> First group <br>
<input name="group" type="checkbox" value="2"> Second group <br> |
If you want the user to be subscribed to one or more groups, without presenting a choice, simply set the type as “hidden”, as in the example below:
Code Block | ||
---|---|---|
| ||
<input name="group" type="hidden" value="2,8,10"> |
In the example above, the user is automatically subscribed to groups 2, 8 and 10. The Group IDs are listed in your MailUp admin console under Settings > Codes table.
Other personal data fields (optional)
...
...
...
...
...
...
...
...
...
...
...
The field type is entirely up to you. The field name is based on the field ID located in the Codes Table and List GUID.
Modifying the sender email and name
...
...
...
...
...
...
This allows to send a subscription confirmation message with a personalized sender. When both have been specified, they will be set as the values in the “From” field, while the default name and email address for the MailUp list will be used for the “Sender” field. So, on many clients this message will be viewed as “sent by Sender on behalf of From”. A confirmation email like this contains a link to the newsletter management system to complete the subscription, while, if the recipient replies to the email message (“Reply to”), the reply will be sent to the address indicated in the “From” field. This practice is very useful when a confirmation email is sent to an acquaintance: the invitation is much more effective if the person who invites is among the senders of the email (in the “From” field).
Xmlsubscribe.aspx (User subscription)
This call is similar to the previous one: the main differences is in the format with which the parameters are defined, and in the fact that "xmlSubscribe" returns an output code with information about the outcome of the operation, when instructed to do so.
URL
The URL to use depends on your MailUp account's unique URL. If your MailUp admin console address is xyzw.espsrv.com, the correct action URL for the form (the URL of the form handler) will be http://xyzw.espsrv.com/frontend/xmlSubscribe.aspx
REQUEST PARAMETERS
...
Name
...
Mandatory?
...
Description
...
...
N (1)
...
User email address
...
Sms
...
N (1)
...
User mobile number, with international prefix (2)
...
List
...
Y
...
List IDs: you can specify more than one list using comma as separator.
In case of more lists and if you don't specify ConfirmListID(4) value, a confirmation request message will be sent for each specified list.
Otherwise, when there are more lists and ConfirmListID is specified with a valid list ID value, a single email message can be used to confirm subscription to all the lists that are specified with "List" parameter.
...
Group
...
N
...
Groups to which to subscribe the user (comma separated)
...
Confirm
...
N
...
Parameter to enable ("1" or "true") or disable ("0" or "false") the confirmation request email. Default value: 1 (i.e. double opt-in enabled by default).
...
csvFldNames
...
N
...
Personal data codes (separated by the ";" character)
...
csvFldValues
...
N
...
Values related to personal data codes (separated by the ";" character)
...
retCode
...
N
...
Set it to 1 to receive a response code instead of a text string. It defaults to 0.
...
Dynsndmail(3)
...
N
...
"dynamic sender e-mail address" Sender address in the confirmation request email (If blank, default value for the list will be used)
...
dynsndname(3)
...
N
...
"dynamic sender name" Sender name in the confirmation request email (If blank, default value for the list will be used)
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...