Skip to main content

Microsoft Teams Notifications

You can get notified in a Microsoft Teams channel whenever the status of your deployed application changes — for example when a new version is successfully deployed, when a sync fails, or when the application becomes unhealthy.

This is completely optional and enabled per deployment.

How to Enable It​

To activate Teams notifications for a deployment, add a notifications.teams.webhook_url entry to your deployment's additional_config, with your Teams channel's incoming webhook URL as its value:

{
  "deploy_name": "my-deployment",
  "image_tag": "1.0.0",
  "additional_config": {
    "notifications": {
      "teams": {
        "webhook_url": "https://<your-tenant>.environment.api.powerplatform.com/powerautomate/.../triggers/manual/paths/invoke"
      }
    }
  }
}

That's all you need to do. Once the deployment is created with this webhook URL, the platform automatically starts sending status notifications to the configured Teams channel.

What Happens Automatically​

After the deployment is created, CAIP configures the notifications in the background. Application health and synchronization changes are reported to the platform and the deployment status is updated automatically, with no need for additional endpoint calls or configuration changes.

The status combines both values. For example, a healthy and synchronized deployment is shown as:

Healthy / Synced
info

If you do not set notifications.teams.webhook_url, no notifications are sent — this feature stays off by default.

note

The webhook URL must use HTTPS and point to a Microsoft Teams / Power Automate webhook host (*.environment.api.powerplatform.com). This should happen naturally when creating a new webhook for alerts in a Teams channel / chat using the Workflows tab.

Other URLs are rejected when the deployment is created. Your webhook URL is stored securely and is never shown back in API responses.

Getting a Webhook URL​

The webhook_url value is an incoming webhook URL for the Teams channel where you want to receive the notifications. You create one from within Microsoft Teams by adding a Workflows (Power Automate) incoming webhook to your channel and copying the generated URL.