**Alert Relay Documentation**

Guidance for building Alert Relay flows, choosing the right action, and understanding SharePoint version-history comparisons.

# Alert Relay Documentation

Alert Relay helps you build better SharePoint notifications in Power Automate.

Instead of relying on basic "item changed" messages, Alert Relay can:

- generate ready-to-use HTML for SharePoint list item/document/page change alert emails
- return detailed field-level changes as structured JSON
- help you work with SharePoint `TriggerWindowStartToken` values when you need baseline or specific-date logic

## Start here

If you are new to Alert Relay, read these pages first:

1. [Getting Started - Creating Your First Alert Email](/content/alert-relay/docs/getting-started/index.html)
2. [Troubleshooting](/content/alert-relay/docs/troubleshooting/index.html)

## Choose the right action

### Use [Get Detailed Item Alert HTML](/content/alert-relay/docs/get-detailed-item-alert-html/index.html) when:

- you want to send an alert email showing what changed in a SharePoint item
- you want Alert Relay to generate the email body and subject for you
- you want Alert Relay to generate the email body for you instead of building it manually in Power Automate

### Use [Get Detailed Item Changes](/content/alert-relay/docs/use-detailed-json-changes/index.html) when:

- you want to compare previous and current values for specific fields
- you want to branch on change scenarios such as `Draft` to `Approved`
- you want full control over the flow output

### Use [Parse Compare From](/content/alert-relay/docs/parse-compare-from/index.html) when:

- you want to inspect the date and time inside a `TriggerWindowStartToken`
- you want to apply specific-date or cutover logic before calling the main actions

## Documentation sections

### Get Started

- [Getting Started - Creating Your First Alert Email](/content/alert-relay/docs/getting-started/index.html)

### Build Flows

- [Get Detailed Item Alert HTML](/content/alert-relay/docs/get-detailed-item-alert-html/index.html)
- [Use Detailed JSON Changes](/content/alert-relay/docs/use-detailed-json-changes/index.html)
- [Compare From Baselines](/content/alert-relay/docs/compare-from-baselines/index.html)
- [Parse Compare From](/content/alert-relay/docs/parse-compare-from/index.html)

### Help

- [Troubleshooting](/content/alert-relay/docs/troubleshooting/index.html)
- [Administrator Reference](/content/alert-relay/docs/admin-reference/index.html)

### Reference

- [Actions Reference](/content/alert-relay/docs/reference/actions/index.html)

## Common scenarios

### I want a simple SharePoint alert replacement

Start with [Getting Started - Creating Your First Alert Email](/content/alert-relay/docs/getting-started/index.html).

### I want to drive conditions based on what changed

Start with [Use Detailed JSON Changes](/content/alert-relay/docs/use-detailed-json-changes/index.html).

### I need more control over comparisons and trigger tokens

Read [Use Detailed JSON Changes](/content/alert-relay/docs/use-detailed-json-changes/index.html), then [Compare From Baselines](/content/alert-relay/docs/compare-from-baselines/index.html), then [Parse Compare From](/content/alert-relay/docs/parse-compare-from/index.html) if you need token-based logic.