Microsoft TeamsEndpoints
Create Teams endpoint
Add a single pre-verified outbound Microsoft Teams endpoint to a dashboard.
POST /app/integrations/teams/endpoints
Creates one pre-verified Teams endpoint. Admin-trusted — no verification email is sent.
Requires the admin or subscriber role and the integrations feature entitlement.
Request
See API Basics for required headers.
Body
| Field | Type | Required | Description |
|---|---|---|---|
dashboardId | uuid | Yes | Target dashboard |
url | string | Yes | Absolute HTTPS endpoint URL (max 2048 chars). Must use https:// on port 443 with no embedded credentials. Must be a Microsoft Teams Workflows webhook URL (*.logic.azure.com paths that include /workflows/, or *.environment.api.powerplatform.com). Classic *.webhook.office.com connector URLs are rejected. |
managementEmail | string | Yes | Management contact email (max 254 chars). Receives verify/manage flows for public endpoints and delivery-failure alerts. |
componentIds | uuid[] | Yes | At least one component on that dashboard |
locked | boolean | No | Admin-managed flag. When true, blocks dashboard self-service subscribe/manage. Default: false. |
Sample request
curl -X POST https://api.statusdashboard.com/app/integrations/teams/endpoints \
-H "Authorization: Bearer bcf847abf5c6:def456" \
-H "Content-Type: application/json" \
-d '{
"dashboardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"url": "https://prod-15.westus.logic.azure.com/workflows/abc123/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=example",
"managementEmail": "ops@acme.com",
"componentIds": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"],
"locked": false
}'Sample response
Status: 201 Created
The create response includes the full url once. Subsequent list/update responses expose only urlDisplay.
{
"endpoint": {
"channel": "teams",
"dashboardId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"dashboardName": "Acme Status",
"urlHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"url": "https://prod-15.westus.logic.azure.com/workflows/abc123/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=example",
"urlDisplay": "prod-15.westus.logic.azure.com/workflows/…",
"managementEmail": "ops@acme.com",
"verified": true,
"verifiedAt": "2026-06-01T14:22:00.000Z",
"paused": false,
"locked": false,
"suppressed": false,
"componentIds": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"],
"consecutiveFailures": 0,
"createdAt": "2026-06-01T14:22:00.000Z",
"updatedAt": "2026-06-01T14:22:00.000Z"
}
}Error responses
| Status | When |
|---|---|
400 | Invalid body, invalid URL, or component not on dashboard |
403 | Requires admin or subscriber role, integrations feature disabled, or unique-endpoint organization limit exceeded |
404 | Dashboard not found |
409 | Endpoint already subscribed on this dashboard |