Send

Send an email via Microsoft Graph API

Send an email message through Outlook using Microsoft Graph API. Supports HTML and plain text content, multiple recipients, attachments, and various email options.

yaml
type: "io.kestra.plugin.microsoft365.outlook.Send"

Examples

Send a simple email

yaml

id: send_outlook_email
namespace: company.team

tasks:
  - id: send_email
    type: io.kestra.plugin.microsoft365.outlook.Send
    tenantId: "{{ secret('AZURE_TENANT_ID') }}"
    clientId: "{{ secret('AZURE_CLIENT_ID') }}"
    clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
    from: "[email protected]"
    to:
      - "[email protected]"
    subject: "Hello from Kestra"
    body: "<h1>Hello!</h1><p>This email was sent from a Kestra workflow.</p>"
    bodyType: "Html"

Send email with CC, BCC, and plain text

yaml

id: send_detailed_email
namespace: company.team

tasks:
  - id: send_email
    type: io.kestra.plugin.microsoft365.outlook.Send
    tenantId: "{{ secret('AZURE_TENANT_ID') }}"
    clientId: "{{ secret('AZURE_CLIENT_ID') }}"
    clientSecret: "{{ secret('AZURE_CLIENT_SECRET') }}"
    from: "[email protected]"
    to:
      - "[email protected]"
    cc:
      - "[email protected]"
      - "[email protected]"
    bcc:
      - "[email protected]"
    subject: "Important Notification"
    body: "This is a plain text email sent from Kestra workflow."
    bodyType: "Text"

Properties

body *string

Email body

Body content of the email

clientId *string

Client ID

Azure application (client) ID

clientSecret *string

Client Secret

Azure client secret

from *string

From address

Email address to send from (optional, uses authenticated user if not specified)

subject *string

Email subject

Subject line of the email

tenantId *string

Tenant ID

Azure tenant ID (directory ID)

to *array

SubType string

To recipients

List of email addresses to send the email to

bcc array

SubType string

BCC recipients

List of email addresses to blind carbon copy

bodyType string

Body type

Content type of the email body (Html or Text)

cc array

SubType string

CC recipients

List of email addresses to carbon copy

scopes string

Default https://graph.microsoft.com/.default

Scopes

Scopes for Microsoft Graph

userPrincipalName string

User Principal Name

User email to act on behalf of (optional)

Outputs

bccCount integer

Default 0

BCC recipient count

Number of recipients in the 'bcc' field

bodyType string

Body type

Content type of the email body (Html or Text)

ccCount integer

Default 0

CC recipient count

Number of recipients in the 'cc' field

subject string

Email subject

Subject line of the sent email

toCount integer

Default 0

To recipient count

Number of recipients in the 'to' field

​Send

Send