Skip to main content

Send Email via Blink

Send Email via an SMTP Server

List Email Messages via IMAP

Send an Email via Gmail

The Blink platform enables you to trigger a workflow on every new email message using an IMAP server.

On New Message

When configuring email actions, you can choose to write the content using either Markdown or HTML syntax.
  1. Using Markdown (md):
    • Set the Content Field Type parameter to rich text.
    • This enables a rich text editor that supports Markdown formatting.
  2. Using HTML:
    • Set the Content Field Type parameter to regular text.
    • Additionally, set the Content Type parameter to "text/html".
    • This allows you to write content using HTML syntax.
Ensure you configure these parameters correctly based on your preferred formatting style.

​
SMTP Email

​
Creating an SMTP Email Server connection

To create the connection you need:
  • A username
  • A password
  • An SMTP host
  • An SMTP port

​
Creating your connection

  1. In the Blink platform, navigate to the Connections page > Add connection. A New Connection dialog box opens displaying icons of external service providers available.
  2. Select the SMTP Email Server icon. A dialog box with name of the connection and connection methods appear.
  3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.
  4. Select SMTP Email Server as the method to make the connection.
  5. Fill in the parameters:
    • A username
    • The password
    • The SMTP host
    • The SMTP port
  6. (Optional) Click Test Connection to test it.
  7. Click Create connection. The new connection appears on the Connections page.

​
Actions

​
Send Email via an SMTP Server

Send an e-mail using an SMTP server.
ParameterDescription
FromThe email address used to deliver the message. This address should be a verified sender in your SMTP server.
ToList of addresses - each one on a different line - to send the email to.
SubjectThis is the subject of the mail.
ContentThe body of the mail, write up your mail to send as you wish.
Sender Display NameThe sender’s name to be displayed to the recipient (if not specified, defaults to the email’s domain name).
Content TypeRepresentation of the Content-Type in the email body content.
Custom HeadersThe custom headers to add to the email. For Example: Header1:Value1 Header2:Value2 …
Attachment NameThe name of the attachment.
Attachment FilesA comma-separated list of file identifiers for the attachment.
Attachment BodyThe body of the attachment.

​
IMAP Email

​
Creating an IMAP Email Server connection

To create the connection you need:
  • A username
  • A password
  • An IMAP host
  • An IMAP port

​
Creating your connection

  1. In the Blink platform, navigate to the Connections page > Add connection. A New Connection dialog box opens displaying icons of external service providers available.
  2. Select the IMAP Email Server icon. A dialog box with name of the connection and connection methods appear.
  3. (Optional) Edit the name of the connection. At a later stage you cannot edit the name.
  4. Select IMAP Email Server as the method to make the connection.
  5. Fill in the parameters:
    • A username
    • The password
    • The IMAP host
    • The IMAP port
  6. (Optional) Click Test Connection to test it.
  7. Click Create connection. The new connection appears on the Connections page.

​
Actions

​
List Email Messages via IMAP

List email messages for specific email address.
ParameterDescription
Filter Since DateFilters emails sent from the specified date onward.
Include Seen EmailsWhen checked, all emails including those already seen will be displayed. If unchecked, only unseen email messages will be displayed.
LimitThe maximum number of email messages returned.

​
Triggers

​
On New Message

Triggers a workflow on every new message.
Sample Event
{
  "date": "2022-12-20T11:22:45+02:00",
  "subject": "test",
  "from": [
    {
      "PersonalName": "John Doe",
      "AtDomainList": "",
      "MailboxName": "John",
      "HostName": "john@test.com"
    }
  ],
  "sender": [
    {
      "PersonalName": "John Doe",
      "AtDomainList": "",
      "MailboxName": "John",
      "HostName": "john@test.com"
    }
  ],
  "reply_to": [
    {
      "PersonalName": "John Doe",
      "AtDomainList": "",
      "MailboxName": "John",
      "HostName": "john@test.com"
    }
  ],
  "to": [
    {
      "PersonalName": "Bar Foo",
      "AtDomainList": "",
      "MailboxName": "foo",
      "HostName": "foo@test.com"
    }
  ],
  "cc": null,
  "bcc": null,
  "in_reply_to": "",
  "message_id": "<CAGRyKpNGHkvieaAoAPPUP=wSshQdSzaavp1_qW_ieMGAMaS88Q@mail.gmail.com>",
  "body": "this is a test body"
}

​
Actions

Send an e-mail on behalf of Blink.
ParameterDescription
RecipientThe email address of the recipient.
SubjectThe subject of the email.
Content Field TypeThe type of content to send:
• Regular Text - Send a plain text message.
• Rich Text - Send an HTML-formatted message with styling and structure.
ContentThe body of the email as plain text (for Regular Text) / The HTML body of the email (for Rich Text).

For Rich Text example:
<h1>Your Weekly Update</h1>
<p>This is the update content.</p>
Carbon Copy (CC)A list of email addresses to receive a copy of the email, separated by new lines.

For example:
bob@example.com
jane@example.com
These recipients will be visible to all other recipients.
Blind Carbon Copy (BCC)A list of email addresses to receive a blind copy of the email, separated by new lines.

For example:
bob@example.com
jane@example.com
These recipients will not be visible to other recipients.
Content TypeThe representation of the Content-Type header in the email body content.

Important: Make sure to select the text/html when using Rich Text.
Custom HeadersA list of custom headers to add to the email.

For example:
Header1:Value1
Header2:Value2
Attachment FilesA comma-separated list of file identifiers to attach to the email.
Custom Attachment NameThe name for a custom attachment file.
Custom Attachment BodyThe content for a custom attachment file.

​
Send Email Via Gmail

Create the connection by using one of the following methods: ** Ensure the relevant APIs from the following list are enabled: **

​
Creating your connection

  1. In the Blink platform, navigate to the Connections page > Add connection. A New Connection dialog box opens displaying icons of external service providers available.
  2. Select the Gmail icon. A dialog box with name of the connection and connection methods appear.
  3. Edit the name of the connection. At a later stage you cannot edit the name. (Optional)
  4. Click Gmail to authenticate using OAuth.
  5. Sign in using your credentials.

​
Parameters

ParameterDescription
Attachment FilesA comma-separated list of file identifiers for the attachment.
BccA comma-separated list of emails for BCC recipients of the message.
CCA comma-separated list of email for CC recipients of the message.
ContentThe body of the mail.
From User IDThe email of the user from which to send the email.
The special value ‘me’ can be used if the connection is OAuth to identify as the authenticated user.
SubjectThis is the subject of the mail.
ToA comma-separated list of email recipients for the message.

​
Example Output

{
  "id": "1879ef5cc8e70395",
  "threadId": "1879ef5cc8e70395",
  "labelIds": ["UNREAD", "SENT", "INBOX"]
}