Send a Microsoft Teams Message step

The Send a Microsoft Teams Message step can be used to post a message to a Teams channel at any point in a deployment or runbook process, for example to report the outcome of a deployment or alert your team to a failure.

The Send a Microsoft Teams Message step is available from Octopus Server version 2026.4.1197.

Each step targets one or more channels via incoming webhooks. You’ll need a webhook URL for each channel before adding the step. To create one, see Create an Incoming Webhook in the Microsoft Teams documentation.

Add the step

1. Navigate to your project’s deployment process and click Add step.
2. Search for and select Send a Microsoft Teams Message.
3. Give the step a name.
4. Add one or more channels. For each, enter a display name and the incoming webhook URL. You can use an Octopus variable for the URL if you want to vary it per environment or tenant.
5. Enter the message to post.
6. Set conditions to control when the step runs.
7. Save the deployment process.

Message content

The message field supports Octopus variable substitution.

Example

#{Octopus.Project.Name} #{Octopus.Release.Number} to #{Octopus.Environment.Name} has #{if Octopus.Deployment.Error}failed#{else}completed successfully#{/if}. [View deployment](#{Octopus.Web.ServerUri}#{Octopus.Web.DeploymentLink})