YAML for Microsoft Teams

Send a message to a Microsoft Teams channel.

YAML parameters for Microsoft Teams

PARAMETERS
titlerequiredstring
The title of the notification.
recipientsrequiredstring
The recipient of the notification: email address.
contentrequiredstring
Message content to send. Supports Markdown and Buddy variables.
typerequiredstring

Value: MICROSOFT_TEAMS

actionrequiredstring
Unique identifier for the action within the pipeline.
send_as_htmlboolean
Defines whether to send the content as HTML.
file_attachmentsstring[]
The attached files.
trigger_timestring enum
Specifies when the action should be executed.
Allowed enum:
ON_EVERY_EXECUTION,
ON_SUCCESS,
ON_FAILURE,
ON_BACK_TO_SUCCESS,
ON_WARNING,
ON_WAIT_FOR_APPROVE,
ON_TERMINATE
loopstring[]
The list of variables for dynamic action execution. The action runs once for each value.
run_only_on_first_failureboolean
Defines whether the action should be executed on each failure. Restricted to and required if the trigger_time is ON_FAILURE.
disabledboolean
When set to true the action is disabled. By default it is set to false.
timeoutinteger
The timeout in seconds.
ignore_errorsboolean
If set to true the execution will proceed, mark action as a warning and jump to the next action. Doesn't apply to deployment actions.
retry_intervalinteger
Delay time between auto retries in seconds.
retry_countinteger
Number of retries if the action fails.
run_nextstring enum
Defines whether the action should run in parallel with the next one.
Allowed enum:
WAIT_ON_SUCCESS,
IN_SOFT_PARALLEL,
IN_HARD_PARALLEL
trigger_conditionsTriggerConditionYaml[]
The list of trigger conditions to meet so that the action can be triggered.
variablesVariableYaml[]
The list of variables you can use in the action.

Last modified on Apr 27, 2026

YAML examples for Microsoft Teams

Microsoft Teams notification with attachments

yaml
- action: MS Teams notification type: MICROSOFT_TEAMS trigger_time: ON_EVERY_EXECUTION disabled: false title: Build Notification content: |- Build **${execution.id}** has completed. Branch: ${execution.branch} Status: ${execution.status} recipients: https://outlook.office.com/webhook/abc123/IncomingWebhook/xyz789 send_as_html: true file_attachments: - /reports/summary.html - /logs/build.log ignore_errors: false retry_interval: 30 retry_count: 2 timeout: 60

Simple Microsoft Teams notification

yaml
- action: Teams notify type: MICROSOFT_TEAMS title: "Deployment Notification" trigger_time: ON_EVERY_EXECUTION recipients: https://outlook.office.com/webhook/123 content: Build completed