Skip to main content

SMTP

SMTP (Simple Mail Transfer Protocol) connections are used to send emails over the internet by allowing communication between email clients and servers. When you create an SMTP connection in Prophecy, the user credentials you provide are used to establish the connection. This user will always be the sender of an email when you use the Email gem with this connection.

Feature support

The table below outlines whether the connection supports certain Prophecy features.

FeatureSupported
Read data with a Source gemNo
Write data with a Report gemYes
Browse data in the Environment browserNo

Limitations

Only basic authentication is supported. The SMTP server must support plain username and password authentication. Prophecy does not currently support OAuth or other advanced authentication methods for SMTP connections.

Parameters

To create an SMTP connection, enter the following parameters:

ParameterDescription
Connection NameUnique name for the connection (e.g., MySMTPConnection)
URLSMTP server URL (e.g., smtp.gmail.com)
PortSMTP port. Port options may vary between SMTP services.
UsernameYour SMTP username
Password (Secret required)Your SMTP password

Sharing connections within teams

Connections in Prophecy are stored within fabrics, which are assigned to specific teams. Once an SMTP connection is added to a fabric, anyone in the team can use that connection to send emails from a pipeline.