WorqHat
Utility

Send Mail

Category
Communication / Email
Node Type
Action Node (Email Sending)

Overview

The Send Mail Node allows you to send emails directly from your workflow. It’s commonly used for sending notifications, confirmations, reports, or automated messages — all without writing any email or server code.

Description

Send automated emails.

This node helps you send an email through a configured sender identity. You can define the sender, recipient, subject, content, and attachments.

Notifications

Send alerts, welcome emails, or password resets.

Reports

Distribute generated PDFs or data summaries.

When the email is sent, the node returns details such as delivery status and a unique tracking ID.

Input Parameters

Configure the email details.

senderEmailstringRequired
Verified sender email address.
Example
"notifications@example.com"
recipientAddressstringRequired
Recipient email(s). Separate multiple with commas.
Example
"user@example.com"
subjectstringRequired
Email subject line.
Example
"Welcome to our platform!"
bodystringRequired
Email content (HTML or Plain Text).
Example
"<h1>Hello</h1><p>Welcome!</p>"
senderNamestringOptional
Display name for the sender.
Example
"Support Team"
ccstringOptional
CC recipients.
bccarrayOptional
BCC recipients (hidden).
attachmentsarrayOptional
List of file objects or URLs to attach.

Output Parameters

The node returns delivery confirmation.

deliveryStatusstringOptional
'sent', 'failed', or 'queued'.
deliveryIdstringOptional
Unique ID for tracking.
deliveryTimenumberOptional
Time taken in milliseconds.

Output Type

Output Type: JSON

Returns a JSON object with the delivery status and metadata.

Example Usage

Example 1: Simple Welcome Email

Send a basic HTML email.

{  "senderEmail": "welcome@myapp.com",  "recipientAddress": "newuser@gmail.com",  "subject": "Welcome!",  "body": "<p>Thanks for signing up.</p>"}
{  "output": {    "deliveryStatus": "sent",    "deliveryId": "<unique-id@server.com>",    "deliveryTime": 590  }}

Example 2: Email with Attachment

Send a report with a PDF attachment.

{  "senderEmail": "reports@myapp.com",  "recipientAddress": "manager@company.com",  "subject": "Monthly Report",  "body": "Attached is the report.",  "attachments": [    { "fileName": "report.pdf", "url": "https://storage.com/report.pdf" }  ]}
{  "output": {    "deliveryStatus": "sent",    "deliveryId": "<unique-id@server.com>"  }}

How to Use in a No-Code Workflow

1

Add the Node

Add the Send Mail Node to your workflow.

2

Configure Sender

Enter your Sender Email (must be verified) and Sender Name.

3

Set Recipient

Enter the Recipient Address.

4

Compose

Write the Subject and Body (you can use HTML).

5

Attach (Optional)

Add files under Attachments if needed.

Configure Sender Identity

Before sending, you must verify your sender identity:

1

WorqHat Domain

Use the provided subdomain (e.g., xyz@notifs.worqhat.com). No setup required.

2

Your Domain

Add DNS records to verify ownership of your custom domain.

3

Email Address

Verify a single email address by clicking a link sent to your inbox.

Best Practices

  • Always use a verified sender to avoid spam folders.
  • Keep HTML simple for better compatibility across email clients.

Do / Don’t

Do
  • ✔️ Test emails by sending them to yourself first.
  • ✔️ Use clear, concise subject lines.
  • ✔️ Log the deliveryId for troubleshooting.
Don’t
  • ❌ Don’t send large attachments (use links instead).
  • ❌ Don’t use spammy keywords in the subject line.

Common Errors

Sender not verifiedErrorOptional
The 'From' address is not authorized.
Email not sentErrorOptional
Recipient address invalid or bounced.

Example Workflow Integration

Use Case: Form Confirmation

Send an email when a user submits a form.

  1. Form Trigger: User submits contact form.
  2. Send Mail: Send "We received your message" email.
  3. Return State: Show success message on website.

Workflow Data Flow:

{{form.email}} →  {{sendMail.recipientAddress}}
{{sendMail.deliveryStatus}} →  {{returnState.status}}