Alert Relay (Preview)
Alert Relay helps replace retiring SharePoint Alerts with richer, modern notifications. It returns detailed field-level changes and ready-to-use alert HTML so you can show exactly what changed instead of generic modified notifications.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | independNET Support |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Connector Metadata | |
|---|---|
| Publisher | independNET Products |
| Website | https://independnet.com.au/alert-relay/ |
| Privacy policy | https://independnet.com.au/alert-relay/privacy |
| Categories | Collaboration;Productivity |
Alert Relay
Alert Relay helps replace retiring SharePoint Alerts with richer, modern notifications for Microsoft 365 environments. It provides detailed SharePoint item and document change information, including formatted field-level comparisons and ready-to-use HTML alert output.
Overview
Alert Relay is designed for makers who want more useful SharePoint notifications than the default "item was modified" experience.
It supports:
- detailed field-level change inspection
- ready-to-use HTML output for alert emails
- trigger token parsing for baseline and first-run decisions
- SharePoint lists
- document libraries
- Site Pages / page libraries
Key Features
1. Detailed change tracking
The connector can compare the current version of a SharePoint item or document against an earlier version and return structured change details.
2. Ready-to-use HTML alert output
The connector can generate formatted HTML so flows can send useful alert emails without building complex HTML expressions manually.
3. Trigger token parsing
The Parse Compare From action decodes SharePoint change tokens such as TriggerWindowStartToken and returns the embedded timestamp and token details for decision-making in flows.
4. Dynamic dropdowns
The connector includes dynamic dropdown support for:
- sites
- lists and libraries
- date formats
- time formats
- timezones
5. Flexible comparison baseline
The connector supports comparing from:
- SharePoint trigger tokens
- raw SharePoint change tokens
- version labels
- ISO 8601 date/date-time baselines
Supported Actions
Get Detailed Changes
Returns structured JSON describing changed fields, including previous and current formatted values.
Get Detailed Changes as Alert HTML
Returns ready-to-use HTML output and related alert metadata for email or other HTML-capable destinations.
Parse Compare From
Decodes a SharePoint trigger/change token and returns the embedded timestamp and token details.
Typical Use Cases
- Send better SharePoint alert emails when a list item changes
- Show previous and current values for important business fields
- Track document library metadata changes
- Build approval, compliance, or audit notification flows
- Suppress noisy first-run alerts by evaluating trigger token dates against a chosen baseline
Authentication
Alert Relay uses Microsoft Entra ID authentication together with an API subscription key.
To use the connector, a user needs:
- access to the relevant SharePoint site, list, or library
- a valid Alert Relay connection
- a valid Alert Relay API subscription key
When a tenant first uses Alert Relay, it is placed into trial mode automatically. To move out of trial mode, contact support@alertbridge.com.au.
Getting Started
A typical validation flow uses:
- A SharePoint trigger such as
When an item is created or modified - An Alert Relay action such as
Get Detailed Changes as Alert HTML - An email or Compose step to use the returned subject and HTML output
For structured downstream processing, use Get Detailed Changes and iterate over the returned changedFields array.
Known Issues And Limitations
- SharePoint Online is supported; SharePoint Server on-premises is not supported.
- SharePoint trigger timing can affect first-run comparisons because trigger tokens reflect the SharePoint trigger window rather than a per-item alert history.
Support
Website:
Privacy Policy:
Support:
Support email:
- support@alertbridge.com.au
Additional Notes
Alert Relay is intended to improve usability for SharePoint-based notification scenarios by reducing the amount of custom expression work required in flows, especially for HTML email formatting and field-level change inspection.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Get Detailed Item Alert HTML |
Returns ready-to-use Alert Relay HTML for SharePoint item changes, designed primarily for SharePoint-style alert emails but also usable in documents or other HTML-capable destinations. |
| Get Detailed Item Changes |
Retrieves detailed, formatted field-level changes for a SharePoint list item or document, comparing the current version with the previous version. Use this when you want rich change data rather than the built-in SharePoint-style true/false field flags. |
| Parse Compare From |
Decodes a TriggerWindowStartToken or raw SharePoint change token and returns the embedded timestamp for flow conditions and baseline decisions. This action does not call SharePoint. |
Get Detailed Item Alert HTML
Returns ready-to-use Alert Relay HTML for SharePoint item changes, designed primarily for SharePoint-style alert emails but also usable in documents or other HTML-capable destinations.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Site URL
|
siteUrl | True | string |
Full URL of the SharePoint site containing the list or library. |
|
List or Library
|
listId | True | string |
GUID or exact title of the SharePoint list or library. The dropdown returns GUID values, but manual entry can use either a GUID or the exact list title. |
|
Item ID
|
itemId | True | integer |
ID of the SharePoint item or file to analyze for changes. |
|
Compare From
|
triggerWindowStartToken | string |
Defines the starting point for change comparison. Accepts the SharePoint trigger's {TriggerWindowStartToken} (recommended), a version label such as '5.0', a raw SharePoint change token, or an ISO 8601 baseline date/date-time such as '2026-03-30' or '2026-03-30T14:15:00Z'. Date-only values are interpreted as midnight in the selected Timezone, or UTC if Timezone is blank. Omit to compare against the immediately previous version. |
|
|
Include Minor Versions
|
includeMinorVersions | boolean |
Whether minor or draft versions should participate in the comparison. Defaults to false, which means only major versions are used. |
|
|
Include Unchanged Fields
|
includeUnchangedFields | boolean |
Whether unchanged fields should be included in the generated HTML. Defaults to true. |
|
|
Date Format
|
dateFormat | string |
Custom date format for DateTime fields (for example, 'yyyy-MM-dd', 'dd/MM/yyyy'). Defaults to 'yyyy-MM-dd' if not specified. |
|
|
Time Format
|
timeFormat | string |
Time format appended to date for DateTime fields with time (for example, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
IANA timezone ID for date/time conversion (for example, 'America/New_York', 'Europe/London', 'Australia/Sydney'). |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indicates whether the operation completed successfully |
|
Message
|
message | string |
Human-readable message describing the result |
|
HTML Body
|
htmlBody | string |
Complete HTML body ready to use in alert emails or other HTML-capable destinations |
|
Suggested Subject
|
subject | string |
Suggested subject line for the alert |
|
Item Title
|
itemTitle | string |
Title of the changed item |
|
Item URL
|
itemUrl | string |
Direct link to the changed SharePoint item |
|
Is New Item
|
isNewItem | boolean |
True if the alert is for a new SharePoint item or file rather than an update to an existing one. |
|
Error
|
error | string |
Error details if success is false |
Get Detailed Item Changes
Retrieves detailed, formatted field-level changes for a SharePoint list item or document, comparing the current version with the previous version. Use this when you want rich change data rather than the built-in SharePoint-style true/false field flags.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Site URL
|
siteUrl | True | string |
Full URL of the SharePoint site containing the list or library (for example, |
|
List or Library
|
listId | True | string |
GUID or exact title of the SharePoint list or library. The dropdown returns GUID values, but manual entry can use either a GUID or the exact list title. |
|
Item ID
|
itemId | True | integer |
ID of the SharePoint item or file to analyze for changes (available from trigger outputs as ID). |
|
Compare From
|
triggerWindowStartToken | string |
Defines the starting point for change comparison. Accepts the SharePoint trigger's {TriggerWindowStartToken} (recommended), a version label such as '5.0', a raw SharePoint change token, or an ISO 8601 baseline date/date-time such as '2026-03-30' or '2026-03-30T14:15:00Z'. Date-only values are interpreted as midnight in the selected Timezone, or UTC if Timezone is blank. Omit to compare against the immediately previous version. |
|
|
Include Minor Versions
|
includeMinorVersions | boolean |
Whether minor or draft versions should participate in the comparison. Defaults to false, which means only major versions are used. |
|
|
Include Unchanged Fields
|
includeUnchangedFields | boolean |
Whether unchanged fields should be included in the response. Defaults to true. |
|
|
Date Format
|
dateFormat | string |
Custom date format for DateTime fields (for example, 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy'). Defaults to 'yyyy-MM-dd' if not specified. |
|
|
Time Format
|
timeFormat | string |
Time format appended to date for DateTime fields with time (for example, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). Defaults to 'HH:mm:ss' if not specified. |
|
|
Timezone
|
timezone | string |
IANA timezone ID for date/time conversion (for example, 'America/New_York', 'Europe/London', 'Australia/Sydney'). Defaults to UTC if not specified. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indicates whether the operation completed successfully |
|
Message
|
message | string |
Human-readable message describing the result |
|
Changed Fields
|
changedFields | array of object |
Tracked fields as an array. |
|
Column Value Has Changed
|
changedFields.hasChanged | boolean |
True if this field's value changed between the previous and current version |
|
Previous Column Value (Text)
|
changedFields.previousAsString | string |
Formatted previous value as a human-readable string |
|
Field Internal Name
|
changedFields.internalName | string |
Internal SharePoint field name |
|
Field Name
|
changedFields.displayName | string |
Friendly display name for the field |
|
Previous Column Value (Detailed)
|
changedFields.previous |
Raw previous value. This property is dynamic and can be a string, number, boolean, object, array, or null depending on the SharePoint field type. |
|
|
Current Column Value (Text)
|
changedFields.currentAsString | string |
Formatted current value as a human-readable string |
|
Current Column Value (Detailed)
|
changedFields.current |
Raw current value. This property is dynamic and can be a string, number, boolean, object, array, or null depending on the SharePoint field type. |
|
|
Has Comparison Baseline
|
hasComparisonBaseline | boolean |
True if a distinct baseline version was resolved for comparison against the current version. |
|
Is Baseline First Version
|
isBaselineFirstVersion | boolean |
True if the resolved baseline version is the first version ever recorded for the item or file. |
|
Current Version Label
|
currentVersionLabel | string |
Version label of the current version (for example, '2.0', '5.0') |
|
Previous Version Label
|
previousVersionLabel | string |
Version label used for comparison (for example, '1.0', '4.0') |
|
Item Title
|
itemTitle | string |
Title of the changed item |
|
Item URL
|
itemUrl | string |
Direct link to the changed SharePoint item |
|
Modified Date
|
modifiedDate | date-time |
Timestamp of the latest modification |
|
Modified By
|
modifiedBy | string |
Display name of the user who last modified the item |
|
Error
|
error | string |
Error details if success is false |
Parse Compare From
Decodes a TriggerWindowStartToken or raw SharePoint change token and returns the embedded timestamp for flow conditions and baseline decisions. This action does not call SharePoint.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Compare From
|
compareFrom | True | string |
TriggerWindowStartToken or raw SharePoint change token to decode. Version labels and ISO date/date-time values are not supported by this action. |
|
Timezone
|
timezone | string |
Optional IANA timezone ID for a local comparison value (for example, 'America/New_York', 'Europe/London', 'Australia/Sydney'). If omitted, only the UTC value is returned. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Token Date Time UTC
|
tokenDateTimeUTC | date-time |
Token timestamp in UTC. |
|
Token Date Time Local
|
tokenDateTimeLocal | date-time |
Token timestamp converted to the requested timezone. |
|
Decoded Token
|
decodedToken | string |
Decoded raw token text. For raw token input this matches the original value. |
|
Is Base64 Token
|
isBase64Token | boolean |
True when the incoming token was base64 encoded. |
|
Sequence
|
sequence | integer |
SharePoint change sequence value embedded in the token. |
|
List GUID
|
listGuid | uuid |
List or library GUID embedded in the token. |
|
Token Version
|
tokenVersion | integer |
Token version number. |
|
Token Type
|
tokenType | integer |
SharePoint token type number. |
|
Error
|
error | string |
Error details when parsing fails. |