← All articles
Developer API, MCP and webhooks·

Set up Getwello with Microsoft Teams

Post Adaptive Cards to a Teams channel via Incoming Webhook. Free with Microsoft 365.

Wire Getwello into a Microsoft Teams channel so check-ins arrive as Adaptive Cards rather than raw text.

What you need

  • Microsoft Teams (personal or work).
  • A Getwello Coordinator account with active subscription.
  • 10 minutes.

Step 1: Add an Incoming Webhook to your Teams channel

  1. Open the channel in Teams. Click the … menu → Manage channel → Connectors (or Apps).
  2. Find “Incoming Webhook”, click Add.
  3. Name it “Getwello”, upload an icon if you like, click Create.
  4. Copy the URL Teams gives you.

Step 2: Pick how to format the message

Teams supports rich Adaptive Cards. For the easiest setup, route through Zapier or a Worker that reshapes our event into a Card payload.

Example Adaptive Card body:

{
  "type": "message",
  "attachments": [{
    "contentType": "application/vnd.microsoft.card.adaptive",
    "content": {
      "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
      "type": "AdaptiveCard",
      "version": "1.4",
      "body": [
        { "type": "TextBlock", "text": "Mum has just checked in",
          "weight": "Bolder", "size": "Large", "color": "Good" },
        { "type": "FactSet", "facts": [
          { "title": "Time", "value": "08:14 BST" },
          { "title": "Mood", "value": "Fine" }
        ]}
      ]
    }
  }]
}

Step 3: Create the Getwello webhook subscription

Settings → Developer API → Webhooks. URL is the Teams webhook URL (or your Zapier/Worker URL if you added a reshape step).

Test

Click Test. The card appears in the Teams channel within a couple of seconds.

Troubleshooting

Card displays but is ugly: double-check the JSON validates as an Adaptive Card v1.4 payload. Adaptive Cards Designer previews it.

IT blocks the connector: some corporate tenants restrict Incoming Webhooks. Ask IT to allow it on a specific channel, or use a personal Teams account.

More on developer api, mcp and webhooks

Didn't answer your question?

Email hello@getwello.co.uk