Get user changes
BetaReads data
Finds the people added, edited or removed in your directory since the last check.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | The Microsoft Graph connection the step signs in with. |
| Delta link | Leave empty to read everyone once. Put the delta link a previous run answered here to read only what changed since. |
| Fields | Comma-separated property names to track. Used when Delta link is empty — the link carries them after that. |
| Filter | Only id eq '…' terms joined with or, at most 50 ids. Used when Delta link is empty. |
| Changed properties only | With a delta link, a person carries only the properties that changed. |
| Stop after | Pages — at most 50. A round still going then answers the link to carry on from. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `microsoft-graph`) |
deltaLink | text |
select | text, by default "id,displayName,mail,userPrincipalName,accountEnabled" |
filter | text |
minimal | true/false, by default false |
maxPages | number, by default 10 |
Output
| Field | Type |
|---|---|
usersChanged people | array |
countChanges in this answer | number |
hasMoreMore changes are waiting behind the link | boolean |
deltaLinkDelta link for the next run | string |
Sample output, and the expression for each field
- count0
- deltaLink"https://graph.microsoft.com/v1.0/users/delta?$deltatoken=1"
- hasMorefalse
- users[]
Errors
When a step of this node stops a run, the run page shows a code. Look it up:
Example step
The step as a flow file holds it. Replace each value in <…>.
{
"config": {
"connection": "<connection id>",
"deltaLink": "",
"filter": "",
"maxPages": 10,
"minimal": false,
"select": "id,displayName,mail,userPrincipalName,accountEnabled"
},
"label": "Get user changes",
"type": "graph.getUserChanges",
"version": 1
}