Custom Action → Custom API Call
AI-generatedSummary
Perform a custom HTTP request to the Microsoft Graph API for a specified Azure AD tenant using dynamic API version, method, endpoint, and optional request parameters.
Inputs
- Tenant Source (required) — Select whether to choose a tenant from a dropdown list or input a tenant ID manually.
- Customer Tenant (tenantId) (required) — Select the customer tenant ID from a dynamically loaded list (shown if 'Tenant Source' is 'From List').
- Tenant ID (tenantIdManual) (required) — Enter the Azure AD tenant ID manually (shown if 'Tenant Source' is 'By ID').
- API Version (customApiVersion) (required) — Choose the Microsoft Graph API version to call ('v1.0' or 'beta').
- HTTP Method (customMethod) (required) — Select the HTTP method (GET, POST, PUT, PATCH, DELETE) for the request.
- Resource Endpoint (customEndpoint) (required) — Specify the API resource path, excluding the API version prefix (e.g., '/users', '/security/alerts').
- Return All (returnAll) — Optionally follow OData pagination to retrieve all records instead of a single page.
- JSON Body (customJsonBody) — Provide a JSON payload for the request body, applicable for POST, PUT, or PATCH methods.
- Options: Custom Body (customBody) — Provide arbitrary JSON to merge into the request body, supplementing 'JSON Body'.
- Options: Custom Headers (headerFilters) — Add custom HTTP headers as key-value pairs for the API request.
- Options: Query Filters (queryFilters) — Add query string parameters as key-value pairs to be included in the API request URL.
- Options: Debug — Enable to include detailed request info in the output for troubleshooting.
- Options: Timeout (ms) — Set the request timeout in milliseconds (default 300000 ms).
Output shape
a list of JSON objects representing the API response records or a single JSON object for non-array responses
If 'Return All' is enabled, the node paginates through the OData '@odata.nextLink' to collect all results. The output is an array of items, each containing one response record in 'json'. On failure, errors may be included in output if 'Continue On Fail' is enabled; otherwise the node will error. Debug option may add request details to the output.
Examples
Example 1: Make a GET request to list all users in a customer's Azure AD tenant
Tenant Source: From List; Customer Tenant: selected tenant; API Version: v1.0; HTTP Method: GET; Resource Endpoint: /users; Return All: true;
Example 2: Create a new conditional access policy using a POST request
Tenant Source: By ID; Tenant ID: manually entered; API Version: beta; HTTP Method: POST; Resource Endpoint: /identity/conditionalAccess/policies; JSON Body: policy definition JSON;