Microsoft Teams Workflows (webhook)

Workflows for Teams (Webhook-style)

If you don’t need a full Bot identity or Direct Message capabilities, then you can support a simplified, channel-only integration using Workflows for Microsoft Teams. This approach relies on a unique Webhook URL generated by the Teams client. It requires no Azure app registration and no administrator consent.

User generates the webhook URL (Teams client)

The setup begins inside the Microsoft Teams app. Instruct your users to follow these steps:

Open Workflows

In Microsoft Teams, go to Apps in the sidebar. Search for and open Workflows.

Create a new flow

Start from a blank flow or use a template.

Choose a trigger

For example, select When a Teams webhook request is received.

Add a post message action

Add an action to post a message into a specific channel.

Save the workflow

Publish your changes so the Teams workflow can receive events.

Copy the webhook URL

Once created, the workflow generates a unique URL. The user must copy this URL.

Register the webhook endpoint (Novu)

Unlike the Bot integration, you don’t use ms_teams_channel here. Instead, you treat this as a generic webhook endpoint. Your app should provide a form where the user can paste the URL they generated in the previous step.

import { Novu } from '@novu/api';

const novu = new Novu({ secretKey: "<NOVU_SECRET_KEY>" });

await novu.channelEndpoints.create({
  type: 'webhook',
  identifier: 'teams-workflow-alerts',
  integrationIdentifier: 'ms-teams-workflow',
  subscriberId: 'customer-account-id',
  context: { tenant: 'acme' },
  endpoint: { url: 'https://prod-00.westeurope.logic.azure.com:443/workflows/...' },
});

import os
from novu_py import Novu

with Novu(secret_key=os.getenv("NOVU_SECRET_KEY", "")) as novu:
    novu.channel_endpoints.create(request_body={
        "type": "webhook",
        "identifier": "teams-workflow-alerts",
        "integration_identifier": "ms-teams-workflow",
        "subscriber_id": "customer-account-id",
        "context": {"tenant": "acme"},
        "endpoint": {"url": "https://prod-00.westeurope.logic.azure.com:443/workflows/..."},
    })

import (
    "context"
    "os"

    novugo "github.com/novuhq/novu-go"
    "github.com/novuhq/novu-go/models/components"
    "github.com/novuhq/novu-go/models/operations"
)

s := novugo.New(novugo.WithSecurity(os.Getenv("NOVU_SECRET_KEY")))

res, err := s.ChannelEndpoints.Create(context.Background(), operations.CreateChannelEndpointsControllerCreateChannelEndpointRequestBodyWebhook(
    components.CreateWebhookEndpointDto{
        Identifier: novugo.String("teams-workflow-alerts"),
        IntegrationIdentifier: "ms-teams-workflow",
        SubscriberID: "customer-account-id",
        Context: map[string]any{
            "tenant": "acme",
        },
        Type: components.CreateWebhookEndpointDtoTypeWebhook,
        Endpoint: components.WebhookEndpointDto{URL: "https://prod-00.westeurope.logic.azure.com:443/workflows/..."},
    },
), nil)

use novu;
use novu\Models\Components;

$sdk = novu\Novu::builder()->setSecurity('<NOVU_SECRET_KEY>')->build();
$sdk->channelEndpoints->create(
    requestBody: new Components\CreateWebhookEndpointDto(
        identifier: 'teams-workflow-alerts',
        integrationIdentifier: 'ms-teams-workflow',
        subscriberId: 'customer-account-id',
        context: [
            'tenant' => 'acme',
        ],
        type: Components\CreateWebhookEndpointDtoType::Webhook,
        endpoint: new Components\WebhookEndpointDto(url: 'https://prod-00.westeurope.logic.azure.com:443/workflows/...'),
    ),
);

using Novu;
using Novu.Models.Components;

var sdk = new NovuSDK(secretKey: "<NOVU_SECRET_KEY>");
await sdk.ChannelEndpoints.CreateAsync(
    requestBody: CreateWebhookEndpointDto.CreateWebhook(
        new CreateWebhookEndpointDto() {
            Identifier = "teams-workflow-alerts",
            IntegrationIdentifier = "ms-teams-workflow",
            SubscriberId = "customer-account-id",
            Context = new Dictionary<string, object> {
                { "tenant", "acme" },
            },
            Type = CreateWebhookEndpointDtoType.Webhook,
            Endpoint = new WebhookEndpointDto() { Url = "https://prod-00.westeurope.logic.azure.com:443/workflows/..." },
        }));

import co.novu.Novu;
import co.novu.models.components.*;

Novu novu = Novu.builder().secretKey("<NOVU_SECRET_KEY>").build();
novu.channelEndpoints().create()
    .requestBody(CreateWebhookEndpointDto.builder()
        .identifier("teams-workflow-alerts")
        .integrationIdentifier("ms-teams-workflow")
        .subscriberId("customer-account-id")
        .context(java.util.Map.of("tenant", "acme"))
        .type(CreateWebhookEndpointDtoType.WEBHOOK)
        .endpoint(WebhookEndpointDto.builder().url("https://prod-00.westeurope.logic.azure.com:443/workflows/...").build())
        .build())
    .call();

curl -L -X POST 'https://api.novu.co/v1/channel-endpoints' \
-H 'Content-Type: application/json' \
-H 'Authorization: ApiKey <NOVU_SECRET_KEY>' \
-d '{
  "type": "webhook",
  "identifier": "teams-workflow-alerts",
  "integrationIdentifier": "ms-teams-workflow",
  "subscriberId": "customer-account-id",
  "context": {
    "tenant": "acme"
  },
  "endpoint": {
    "url": "https://prod-00.westeurope.logic.azure.com:443/workflows/..."
  }
}'

Sending the notification

When you trigger a workflow that targets this subscriber:

Novu sends HTTP POST

Novu sends a standard HTTP POST payload to the Teams Workflow URL.

Workflows receives payload

Workflow posts message

The Workflow runs and posts the message content into the configured channel.

MS Teams overview

Compare the bot, webhook, and agent paths.

Getting Started

Integrate <Inbox />

Integrate <Subscription />

Build a Workflow

Integrate Channels Providers

SDKs

Developer

Account

Build with AI

Additional Resources

Microsoft Teams Workflows (webhook)

Workflows for Teams (Webhook-style)

User generates the webhook URL (Teams client)

Register the webhook endpoint (Novu)

Sending the notification

MS Teams overview

​Workflows for Teams (Webhook-style)

​User generates the webhook URL (Teams client)

​Register the webhook endpoint (Novu)

​Sending the notification

​Related

MS Teams overview

Workflows for Teams (Webhook-style)

User generates the webhook URL (Teams client)

Register the webhook endpoint (Novu)

Sending the notification

Related