
Microsoft 365 TeamsExecution
CertifiedSend Teams notification with execution details
Microsoft 365 TeamsExecution
Send Teams notification with execution details
Renders a template with execution metadata (ID, namespace, flow, start time, duration, status, failing task) and posts via Teams webhook. Use with Flow triggers; for errors handlers prefer TeamsIncomingWebhook. No Graph permission required.
type: io.kestra.plugin.microsoft365.teams.TeamsExecutionExamples
Send a Microsoft Teams notification on a failed flow execution.
id: failure_alert
namespace: company.team
tasks:
- id: send_alert
type: io.kestra.plugin.microsoft365.teams.TeamsExecution
url: "{{ secret('TEAMS_WEBHOOK') }}" # format: https://microsoft.webhook.office.com/webhook/xyz
activityTitle: "Kestra Teams notification"
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
url *Requiredstring
1Teams incoming webhook URL
activitySubtitle string
Activity subtitle
activityTitle string
Activity title
customFields object
Custom fields to be added on notification
customMessage string
Custom message to be added on notification
executionId string
{{ execution.id }}The execution id to use
Default is the current execution, change it to {{ trigger.executionId }} if you use this task with a Flow trigger to use the original execution.
options
HTTP client options
Optional timeouts, charset, headers, and limits for Teams webhook calls
io.kestra.plugin.microsoft365.teams.AbstractTeamsConnection-RequestOptions
The time allowed to establish a connection to the server before failing.
PT0SIdle pool timeout
Time an idle connection stays in the pool before closing
UTF-8Default charset
java.nio.charset.Charset
HTTP headers
HTTP headers to include in the request
10485760Max response size
Maximum response content length in bytes
PT5MThe time allowed for a read connection to remain idle before closing it.
PT10SThe maximum time allowed for reading data from the server before failing.
payload string
Teams message payload
Raw JSON payload for the webhook (Adaptive Card or MessageCard)
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
templateRenderMap object
Template variables
Key-value map rendered into the template before sending
themeColor string
0076D7Theme color