Power Automate / Workflows (for MSTeams)
| Schemes | workflow://, workflows:// |
| Cargo feature | service-workflows |
| Service | https://www.microsoft.com/power-platform/products/power-automate |
| Body formats | markdown (first is the default) |
| Attachments | no |
| Title length | 250 characters |
| Body length | 1,000 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | yes |
URL formats
{schema}://{host}/{workflow}/{signature}
{schema}://{host}:{port}/{workflow}/{signature}
{schema} is one of workflow://, workflows://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{host} | Hostname | string | yes | ||
{port} | Port | int, 1 to 65535 | no | ||
{signature} | Signature | string | yes | secret; must match ^[a-z0-9_-]+$ | |
{workflow} | Workflow ID | string | yes | secret; must match ^[A-Z0-9_-]+$ |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
id | Workflow ID | string | sets {workflow} | |
image | Include Image | bool | yes | |
pa | Use Power Automate URL | bool | no | also powerautomate |
route | Power Automate Routing ID | string | also routeid; must match ^[0-9]+$ | |
sig | Signature | string | sets {signature} | |
template | Template Path | string | secret | |
ver | API Version | string | also api-version | |
wrap | Wrap Text | bool | yes |
Prefixed parameters:
:name=value: Template Tokens
The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.
Examples
Accepted URLs (tokens are fake):
workflow://host/wf/sig
workflows://host:443/workflow1b/signature/
workflow://host/3XXX5/iXXXU/?route=42
workflow://host:443/workflow1a/signature/?image=no
workflows://host/wf1/?sig=abc-def
workflows://host:443/signature/?id=workflow1c
workflows://host:443/workflow1b/signature/?ver=2016-06-01
workflow://host/3XXX5/iXXXU/?pa=yes&routeid=42
Rejected URLs:
workflow://
workflow://:@/
workflow://host/workflow
workflow://host:443/^(/signature
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'workflow://host/wf/sig'
Notes
Power Automate / Workflows for MS Teams (workflow://, workflows://): Adaptive Card messages through a workflow webhook.
?template= reads a local JSON file when the message is sent, or downloads an http(s):// one before the first send and keeps it.