Introduction

Using Descope’s connectors allows you to use SMTP to send emails with your own email servers and trigger sending within the authentication flow. This article will go through setting up and using the connector.

Configure SMTP connector

Descope uses your server hostname, SMTP port, username, password, and sender address for integration. Start at your dashboard. Navigate to the SMTP connector: Dashboard -> Connectors -> SMTP

Now, complete the required fields:

  • Connector name: Custom name for your connector. This will come in handy when creating multiple connectors from the same connector template.
  • Custom base URL: The base URL of the Segment API, when using a custom domain in Segment.
  • Connector name: Custom name for your connector. This will come in handy when creating multiple connectors from the same connector template.
  • Server hostname: The SMTP server's hostname. Can be either domain and IP.
  • SMTP port: The port in which the SMTP service is configured to. Default value is 25.
  • Username: The username used for authenticating with the SMTP server.
  • Password: The password used for authenticating with the SMTP server.
  • Sender address: The email address from which the emails are going to be sent. Make sure those are registered properly in your server.
  • Sender name (Optional): The name of the sender to be added to sender address.
  • Connector description: Describe what your connector is used for.
You can test if your connector's configuration is working properly simply by hitting the Test button and viewing the Test Results panel.

Descope example SMTP connector configuration.

Save your configuration by hitting Create.

Add your SMTP connector to a flow

Navigate to: Flows, choose your flow. Then, tap the create button (designated via the + icon), select Connector, and choose SMTP.

Click to set down the connector in your flow editor and fill out the fields:

  • To: Who the email should be sent to. Setting this dynamically based on previous attributes is recommended (eg. {{user.email}}). As you type in the input field, options appear.
  • Subject: Enter the subject of the email.
  • Body: Enter the body text of the email.
SMTP connector widget input

Now, link your connector at a logical point in your authentication flow, likely at the end of the flow after email has been submitted by the user.


Descope example SMTP connector within flow.

That’s it! Whenever a user goes through your authentication flow, the SMTP connector will be automatically triggered.