How to get your SMTP Credentials
In this How-to article, I'll be showing you how you can get your SMTP credentials for the use in your microletter installation.

What is SMTP?

SMTP is the protocol used to send emails. If you don't know what SMTP is, start here.
A rough example of how SMTP works Imagine the Server being the address and the Port being the apartment number. To send an email, microletter connects to the SMTP Server. In this example, this connection will be a postman. The postman searches for the building (server) and apartment (port) to find the right door. Before the postman can hand over the letter, he needs to authenticate himself. For that, he uses the Username and Password. If that all worked correctly, the letter (aka. the email) can be delivered.

1. Look up where you can find your credentials

It helps to search [your email provider] smtp settings online to find out where you can find the settings. You need the following credentials to use your microletter installation:
  • SMTP Server (e.g.
  • SMTP Port (e.g. 465)
  • SMTP Username/Email (e.g. [email protected])
  • SMTP Password (normally your email password)
If you're using Gmail and you have...
- 2-Factor Authentication (2FA) disabled, you need to activate this. - 2-Factor Authentication (2FA) enabled, you need to generate an App Password to use as your SMTP Password. You can find out how to do that here.
In both cases, make sure you have completed this captcha challange.

2. Add them to the Deta Space App

You can see how to add the credentials to your microletter installation in the Getting Started guide.

3. Test the credentials

After you've done that, go back to the microletter setup page or to the settings page and click "Test the credentials". You'll be redirected to a new page, and it'll show you if they work or not.