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 for Power Platform and Microsoft 365 Copilot
Alert Relay helps organisations replace classic SharePoint Alerts with modern Power Automate and Copilot Studio solutions. It compares SharePoint items, files and pages against earlier versions and returns structured change information, version history and ready-to-use notification content without requiring makers to build complex SharePoint version comparison logic.
Overview
SharePoint triggers can identify that an item, file or page has changed, but they do not provide a complete comparison of previous and current values.
Building that comparison often requires makers to retrieve versions, interpret change tokens, compare fields and format results for notifications or downstream processing.
Alert Relay centralises that work through reusable actions for Power Automate and Copilot Studio.
Key Features
Alert Relay centralises that work through reusable actions that can:
- identify detailed field-level changes
- return previous and current field values
- generate ready-to-use HTML for SharePoint alert emails
- retrieve item, file and page version history
- compare from a trigger token, change token, version label or date
- format supported complex SharePoint field types
- return structured information for Power Automate and Microsoft 365 Copilot
Alert Relay supports SharePoint lists, document libraries and Site Pages libraries.
Getting Started
A typical SharePoint alert flow includes:
- A SharePoint trigger, such as When an item is created or modified.
- An Alert Relay action, such as Get Item or File Changes as Alert HTML.
- An email or another notification action that uses the returned subject and HTML body.
For conditions, custom formatting or Microsoft Copilot Studio agent scenarios, use Get Detailed Item or File Changes and work with the structured change information it returns.
For historical SharePoint versions, use Get Item or File Version History.
Documentation
Documentation, action reference information, examples and getting-started guidance are available at:
Video Tutorials
Step-by-step walkthroughs, examples and how-to videos are available on the Alert Relay YouTube channel:
Licensing and Trial
Alert Relay licensing is tenant-wide. A single trial or subscription applies across the Microsoft Entra tenant, and its usage units are shared by Alert Relay flows and users in that tenant.
The 90-day trial starts automatically when any Alert Relay action first runs in the tenant and includes 300 usage units shared across the trial. For current plans and further details, see Alert Relay pricing and licensing.
Actions
Get Detailed Item or File Changes
Returns detailed field-level changes between the current version of a SharePoint item, file or page and an earlier version.
The action returns structured information including previous and current values, formatted values and comparison metadata. Use it when a flow or Microsoft Copilot Studio agent needs to inspect, summarise or act on individual changes.
Get Item or File Changes as Alert HTML
Generates ready-to-use HTML showing what changed in a SharePoint item, file or page.
The action also returns a suggested email subject, item title and item link. Use it to create richer SharePoint alert emails without building complex HTML and version comparison expressions in every flow.
Get Item or File Version History
Returns bounded, pageable version history for a SharePoint item, file or page.
The action can return selected SharePoint fields and supports version, date and SharePoint trigger-token boundaries. Use it for historical review, audit, reporting, approval and version-aware workflow scenarios.
Parse SharePoint Version Information
Decodes SharePoint trigger-window and change-token information.
Use this action to retrieve the token timestamp, apply date or version-based decisions, and filter unwanted minor or draft version triggers before calling a detailed change action.
Typical Uses
Alert Relay can help you:
- replace classic SharePoint Alerts with Power Automate flows
- send formatted notifications showing exactly what changed
- compare previous and current values for important business fields
- track changes to document metadata and SharePoint pages
- retrieve SharePoint item and file version history
- build approval, review, governance and audit workflows
- provide structured SharePoint change information to Microsoft 365 Copilot
Authentication and Access
Alert Relay uses Microsoft Entra ID delegated authentication.
SharePoint access is performed in the context of the signed-in user. Alert Relay does not grant users additional SharePoint permissions, so users must already have access to the relevant SharePoint site, list, library, item or file.
Requirements and Supported Scope
- Alert Relay supports SharePoint Online. SharePoint Server on-premises is not supported.
- Actions run when called by Power Automate or another supported client. For change notifications, use an appropriate SharePoint trigger to start the flow.
- Comparisons using SharePoint trigger tokens are based on the SharePoint trigger window. The resulting baseline may differ from an item-specific version boundary.
- Detailed formatting is available for supported SharePoint field types. See the Alert Relay documentation for the current field-type reference.
Support
Website: https://independnet.com.au/alert-relay/
Support: https://independnet.com.au/alert-relay/support
Email: support@alertrelay.com.au
Privacy policy: https://independnet.com.au/alert-relay/privacy
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. |