Versions Compared

Key

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

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 Applications that integrate with MailUp may need to request new MailUp trial accounts if the user of the application is not yet a MailUp user.

Solution

You can build the ability to activate a new trial console via MailUp trial account right into your application by using the MailUp public API endpoint. Here below Below you can find the expected workflow and the technical details for implementing it:.

 

Panel
titleWorkflow
  1. The external application requests account activation using TrialActivation method and specifying an email address that has already been confirmed (i.e. there is no need of an additional email that confirms that email address is valid)
  2. Activation starts and TrialActivationStatus method can be used to get activation status. When activation is in progress, TrialActivationStatus returns a value that is different than 2. While status is different than 2 the external application is not yet able to connect to the console account, the following strings could be displayed:
    1. Value = 3,4 or 6 => “An error happened, the activation will be managed directly by MailUp support”. This result rarely happened during maintenance activities, in which processing was suspended for about 2 hours and then restarted.
    2. Value = 5 or 7 => ”The trial activation is in progress, you’ll receive the account credential soon.”
  3. When activation is completed you’ll receive MailUp account credentials in your inbox and, at the same time,  TrialActivationStatus returns 2.
  4. At this point the MailUp account is available and received credentials can be inserted into the external application to perform authentication on the newly activated account

 

Info
titleIMPORTANT

Access to the resources (lists, messages, subscribers) of newly activated account requires an authentication and authorization process that is different than what is working for "trial activation methods": it needs OAuth2 with a token that has to be periodically refreshed when HTTP 401 error is returned. Please refer to "Samples and Wrappers" if you need a working example of an application that properly uses refresh token to access to MailUp resources.

...