Problem
Platforms provided with MailUp integration connector should be also put in the condition to run console trials activation for those individuals yet to subscribe to Mailup.
Solution
It is possible to build an application with the ability to activate a new trial console via public API endpoint. This is the complete operation list :
Introductory operations
- Activate a developer console at http://developers.mailup.com/setupen
- Setup a new application from the freshly activated developer console (http://help.mailup.com/display/mailupapi/Getting+started)
- Take contact with Mail Up Support ( support@mailup.com ) to log a request for application authorization. ( please provide a description of the application, its name and related clientID )
How to activate a trial console
- This is the URL https://services.mailup.com/API/v1.1/Rest/PublicService.svc/Console/TrialActivation a POST callback must be addressed to, with the following arguments :
{ "Company":"String content", "Email":"String content", "IsUSA":true, "Language":"String content", "NameAndSurname":"String content", "PhoneNumber":"String content", "RegisterToNewsletter":true }
- Passed in arguments, can be sent as Xml or Json according to the user defined value set in the header (http://help.mailup.com/display/mailupapi/Resource+access+data+format)
- Arguments are all mandatory and their meaning can be explained as follows :
- Company = Business Name
- Email = Email address who will be sent of the confirmation request and access information
- IsUSA = Cost centre, put False for activations from the Euro zone, else put True.
- Language = console language, please use one of the following : EN, ES or IT ( English, Spanish or Italian)
- NameAndSurname = Applicant first and family names
- PhoneNumber = Applicant phone number
- RegisterToNewsletter = True if the applicant is intended to receive Mailup Newsletters
- Method callback must be enclosing the API KEY in the header as stated in this page http://help.mailup.com/pages/viewpage.action?pageId=22806545 (Please see Resource Access Requirements)
[Authorization] = "Basic " + Base64(ClientId + ":" + ClientSecret) - Callback response returns an Identity (ID) that can be used to track activation status with a further callback to the following https://services.mailup.com/API/v1.1/Rest/PublicService.svc/Console/TrialActivationStatus. (TrialActivationStatus)
Returned codes from TrialActivationStatus are:
1 – Confirmed (Request has been accepted, activation is ready to start) 2 – Processed (Your trial has been activated and you’ll receive the account credentials in your inbox) 3 – Error (An error occurred and an alert has been notified to our support team in order to solve thi issue) 4 – Manual (MailUp platform is in maintenance mode, your request will be processed as soon as the platform will be restored) 5 – In progress (The trial activation is in progress, soon you’ll receive the account credentials) 6 – Blocked (An error occurred and an alert has been notified to our support team in order to solve thi issue) 7 – Re elaborated (The trial activation is in progress, soon you’ll receive the account credentials)
- Any activation request can be performed with a single callback to TrialActivation and further callbacks looping on TrialActivationStatus until it returns ID=2
Relevant notes
- Automated consoles’ activations require a couple of minutes at least to complete. When completed, the activation process will take care of sending activation confirmation message and login credentials to the applicant’s defined email address
- Login credentials can be only transmitted by email as there’s no API method in charge to.
- Currently there’s no implemented functionality in the MailUp API set to retieve the list of activated consoles from a certain application. This ability is planned to be implemented in the near future.