GoodSender icon

GoodSender

Send transactional, custom, and consent emails through GoodSender

Actions6

Email → Send Custom Email

AI-generated

Summary

Sends a single custom (non-template) email through GoodSender via POST /v1/emails/send, with an HTML, Markdown, or plain-text body. Delivery is consent-gated: the email is held until the recipient approves via GoodSender's Permission Loop, so it may not go out immediately.

Inputs

  • fromEmail (required) — Sender address. Must be on a domain verified in GoodSender.
  • fromName — Sender display name. Sent only if non-blank after trimming.
  • toEmail (required) — Recipient email address. One recipient per execution.
  • toName — Recipient display name.
  • subject (required) — Subject line.
  • contentType — Body format: HTML, Markdown (default), or Text. It decides whether the body is sent as html_content, markdown_content, or text_content.
  • content (required) — Email body, in the selected content type.
  • additionalFields — Optional collection. Reply To Email sets the reply-to address. Send At schedules delivery (must be within 72 hours, converted to a Unix timestamp in seconds). Tag is a custom tracking tag, max 100 characters. Tracking has Track Opens, Track Clicks, and Track Unsubscribes toggles, each sent as true or false.
  • requestOptions — Node settings for batching (items per batch and interval), proxy, timeout (default 10000 ms), and ignoring SSL certificate issues.

Output shape

The parsed JSON response from the GoodSender API for each input item. The node does no post-processing of it.

The response schema isn't defined in the node source. Because delivery depends on recipient consent, a successful API response doesn't mean the email was delivered. Per the operation description, recipients without granted, active consent are declined. Requires GoodSender API credentials. API errors, such as an unverified domain, surface as node errors.

Examples

Example 1: Send a Markdown notification to a user who has already granted consent

From Email: noreply@mydomain.com; To Email: {{$json.email}}; Subject: 'Your report is ready'; Content Type: Markdown; Content: report text with a link.

Example 2: Schedule an HTML newsletter with tracking

Content Type: HTML; Content: HTML body; Additional Fields: Send At = tomorrow, Tag = 'newsletter', Tracking with opens and clicks on.

Links

Discussion