mirror of
https://github.com/ToolJet/ToolJet
synced 2026-04-22 22:17:55 +00:00
58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
|
---
|
||
|
|
id: smtp
|
||
|
|
title: SMTP
|
||
|
|
---
|
||
|
|
|
||
|
|
# SMTP
|
||
|
|
|
||
|
|
The SMTP datasource facilitates the connection between ToolJet applications and email servers, enabling the apps to send emails.
|
||
|
|
|
||
|
|
## Connection
|
||
|
|
|
||
|
|
To connect to an SMTP server, the following credentials are typically required:
|
||
|
|
|
||
|
|
- **Host**
|
||
|
|
- **Port**
|
||
|
|
- **Username**
|
||
|
|
- **Password**
|
||
|
|
|
||
|
|
:::tip Finding configuration details:
|
||
|
|
The SMTP configuration details like host and port can usually be obtained from your email service provider. Here are some general settings for the most commonly used email providers:
|
||
|
|
- **Gmail**: `Host`: smtp.gmail.com; `Port`: 587 or 465 (SSL); `Username`: your full Gmail email address; `Password`: your Gmail password.
|
||
|
|
- **Yahoo Mail**: `Host`: smtp.mail.yahoo.com; `Port`: 465 (SSL); `Username`: your Yahoo Mail email address; `Password`: your Yahoo Mail password.
|
||
|
|
- **Outlook.com/Hotmail**: `Host`: smtp.office365.com; `Port`: 587 or 465 (SSL); `Username`: your Outlook.com/Hotmail email address; `Password`: your Outlook.com/Hotmail password.
|
||
|
|
|
||
|
|
Before saving the configuration, it's possible to test the connection by clicking the "Test Connection" button.
|
||
|
|
:::
|
||
|
|
|
||
|
|
<div style={{textAlign: 'center'}}>
|
||
|
|
|
||
|
|
<img className="screenshot-full" src="/img/datasource-reference/smtp/connect.png" alt="smtp connect" />
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
## Querying SMTP
|
||
|
|
|
||
|
|
To create a query for sending an email, follow these steps:
|
||
|
|
|
||
|
|
1. Open the query panel located at the bottom panel of the editor.
|
||
|
|
2. Click the `+Add` button on the left to create a new query.
|
||
|
|
3. Select `SMTP` from the global datasource.
|
||
|
|
4. Provide the following properties:
|
||
|
|
- **From** `required` : Email address of the sender
|
||
|
|
- **From Name** : Name of the sender
|
||
|
|
- **To** `required` : Recipient's email address
|
||
|
|
- **CC mail to** : Email address of the recipients that will receive a copy of the email, and their email addresses will be visible to other recipients.
|
||
|
|
- **BCC mail to** : Email address of the recipients that will receive a copy of the email but the email addressed will be hidden to other recipients.
|
||
|
|
- **Subject** : Subject of the email.
|
||
|
|
- **Body** : You can enter the body text of the email in either raw text or html format, in their respective fields.
|
||
|
|
- **Attachments** : You can add attachments to an SMTP query by referencing the file from the File Picker component in the attachments field.
|
||
|
|
|
||
|
|
For instance, you can set the `Attachments` field value to `{{ components.filepicker1.file }}` or pass an object `{{ name: 'filename.jpg', dataURL: '......' }}` to include attachments.
|
||
|
|
|
||
|
|
<div style={{textAlign: 'center'}}>
|
||
|
|
|
||
|
|
<img className="screenshot-full" src="/img/datasource-reference/smtp/querysmtp.png" alt="smtp connect" />
|
||
|
|
|
||
|
|
</div>
|