Microsoft GraphCustom request
BetaChanges data
Calls any Microsoft Graph endpoint using a saved connection.
Settings
| Setting | What it is |
|---|---|
| ConnectionRequired | Needs the application permission the endpoint's own Microsoft Graph reference names, granted with admin consent in Microsoft Entra ID. |
| API version | "v1.0" or "beta" |
| Method | "GET" or "POST" or "PUT" or "PATCH" or "DELETE" |
| PathRequired | Everything after the version — e.g. users, me/messages, or users/{{ json.id }}/events. Each step is encoded for you; query parameters belong below. |
| Query parameters | OData parameters like $select, $filter, $top — encoded for you. |
| Headers | Extra request headers, e.g. ConsistencyLevel: eventual or Prefer: outlook.timezone="Europe/Amsterdam". Credentials never belong here — the connection carries them. |
| Body | JSON text or an object — an object is sent as application/json. |
| Fetch every page | Follows Graph's own next-page link on a GET, re-sending your headers on every page, and refuses past Stop after rather than truncating. |
| Stop after | Pages — at most 50. |
| Treat these statuses as data | Comma-separated status codes, e.g. "404, 409". They come back in status instead of failing the node. |
Technical details
| Key | Value |
|---|---|
connection | texta connection id from `requires.connections` (provider `microsoft-graph`) |
version | "v1.0" or "beta", by default "v1.0" |
method | "GET" or "POST" or "PUT" or "PATCH" or "DELETE", by default "GET" |
path | text |
query | object of text, by default {} |
headers | object of text, by default {} |
body | any JSONused when `method` is not "GET" |
pagination | true/false, by default false |
maxPages | number, by default 10used when `pagination` is true |
acceptStatuses | text |
Output
| Field | Type |
|---|---|
statusStatus code | number |
bodyResponse body | any |
headersResponse headers | object |
pagesPages fetched (only with Fetch every page on) | number |
Sample output, and the expression for each field
- bodynull
- headers{}
- pages1
- status200
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": {
"acceptStatuses": "",
"connection": "<connection id>",
"headers": {},
"maxPages": 10,
"method": "GET",
"pagination": false,
"path": "<path>",
"query": {},
"version": "v1.0"
},
"label": "Custom request",
"type": "graph.request",
"version": 1
}