Twilio SendGridMailSend

Twilio SendGridMailSend

Certified

Send workflow email through SendGrid

Delivers HTML or text emails with optional attachments using the SendGrid API and an API key. Supports inline images and fails the task on non-2xx responses.

yaml
type: io.kestra.plugin.twilio.sendgrid.SendGridMailSend

Send an email on a failed flow execution.

yaml
id: unreliable_flow
namespace: company.team

tasks:
  - id: fail
    type: io.kestra.plugin.scripts.shell.Commands
    runner: PROCESS
    commands:
      - exit 1

errors:
  - id: send_email
    type: io.kestra.plugin.twilio.sendgrid.SendGridMailSend
    from: hello@kestra.io
    to:
      - hello@kestra.io
    sendgridApiKey: "{{ secret('SENDGRID_API_KEY') }}"
    subject: "Kestra workflow failed for the flow {{flow.id}} in the namespace {{flow.namespace}}"
    htmlTextContent: "Failure alert for flow {{ flow.namespace }}.{{ flow.id }} with ID {{ execution.id }}"
Properties
Min length1

Sender email address

Must comply with RFC 2822 formatting

Min length1

SendGrid API key

API key used to authenticate SendGrid requests; store as a secret

SubTypestring
Min items1

Recipient email addresses

Each address must comply with RFC 2822 format

File attachments

List of files loaded from Kestra storage and attached to the email; delivered as downloadable attachments

Definitions
name*Requiredstring

Attachment filename

Filename presented to recipients, e.g., 'report.pdf'

uri*Requiredstring

Attachment URI

URI in Kestra internal storage that supplies the file content

contentTypestring
Defaultapplication/octet-stream

Attachment content type

MIME type for the attachment; defaults to application/octet-stream

SubTypestring

Cc recipients

Optional carbon-copy recipients in RFC 2822 format

Inline embedded images

Images loaded from storage and attached with inline disposition for HTML content

Definitions
name*Requiredstring

Attachment filename

Filename presented to recipients, e.g., 'report.pdf'

uri*Requiredstring

Attachment URI

URI in Kestra internal storage that supplies the file content

contentTypestring
Defaultapplication/octet-stream

Attachment content type

MIME type for the attachment; defaults to application/octet-stream

HTML body

Optional HTML content. When both HTML and text are provided, email clients treat them as alternatives and typically favor HTML.

Reference (ref) of the pluginDefaults to apply to this task.

Email subject

Optional subject line rendered from flow variables

Plain text body

Optional text content. When both HTML and text are provided, clients choose based on capability.

Response body returned by the SendGrid API

SubTypestring

Response headers returned by the SendGrid API

Default0

HTTP status code returned by the SendGrid API

More Plugins in this Category

YouTube
YouTube

Tasks that interact with the YouTube Data API.

Business

4 tasks

Clickhouse
Clickhouse

Tasks that connect to ClickHouse via JDBC to run queries and loads.

Data

5 tasks

2 blueprints