Twilio SendGridMailExecution

Twilio SendGridMailExecution

Certified

Email execution summary via SendGrid

Uses bundled HTML and text templates to email execution status, flow metadata, and a UI link through SendGrid. Intended for Flow-triggered alerts; for errors handlers, use SendGridMailSend instead.

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

Send an SendGrid email notification on a failed flow execution.

yaml
id: failure_alert
namespace: company.team

tasks:
  - id: send_alert
    type: io.kestra.plugin.twilio.sendgrid.SendGridMailExecution
    to:
      - hello@kestra.io
    from: hello@kestra.io
    subject: "The workflow execution {{trigger.executionId}} failed for the flow {{trigger.flowId}} in the namespace {{trigger.namespace}}"
    sendgridApiKey: "{{ secret('SENDGRID_API_KEY') }}"
    executionId: "{{ trigger.executionId }}"

triggers:
  - id: failed_prod_workflows
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatus
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespace
        namespace: prod
        prefix: true
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

Custom fields

Additional key-value pairs merged into the template context

Custom message

Optional message rendered into the template alongside execution details

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

Default{{ execution.id }}

Execution ID

Defaults to the current execution ID using an expression

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

Map of variables to use for the message template

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