User activation as a Service

[muety]

Simple API to let MailWhale handle user actications on behalf of your application.

1. App X requests to send a confirmation mail to newly signed up user with some e-mail address
2. MailWhale generates and persists confirmation token for that user and sends out a mail with a link
3. MailWhale handles the link click and changes the status of the user (so it can actively be requested later on)
4. Optionally, a pre-defined webhook is a called to notify app X about to successful activation

[muety]

Alternatively, come up with a more generic solution that only is aware of the concept of an "activation token", associated with arbitrary kinds of data. A token is generated by MailWhale and its activation triggers an HMAC- or pre-shared secret signed webhook callback to the client application.

This way, we could not only support user registrations, but, for instance, also the e-mail-related part of password resets.