CIPP icon

CIPP

Interact with CIPP API

Overview

The node interacts with the CIPP API to retrieve information about tenants. Specifically, the "Get Tenant" operation allows users to fetch detailed data for a specified tenant by providing its tenant ID. This is useful in scenarios where you need to manage or audit tenant-specific configurations, monitor tenant status, or integrate tenant data into workflows.

Practical examples include:

  • Fetching tenant details to display in a dashboard.
  • Automating tenant data synchronization between systems.
  • Auditing tenant configurations as part of compliance checks.

Properties

Name Meaning
Tenant Filter Specify the tenant ID to get details for

Output

The node outputs JSON data containing the details of the requested tenant. The structure typically includes tenant-specific attributes such as tenant ID, name, status, and other metadata provided by the CIPP API. There is no indication that binary data is returned by this operation.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API.
  • The base URL for the API is configured dynamically from the credentials.
  • The node expects the CIPP API to be accessible and properly configured to respond to tenant detail requests.

Troubleshooting

  • Common issues:

    • Invalid or missing tenant ID in the "Tenant Filter" property will result in errors or empty responses.
    • Authentication failures due to incorrect or expired API credentials.
    • Network connectivity problems preventing access to the CIPP API endpoint.
  • Error messages and resolutions:

    • Unauthorized / 401 errors: Check that the API key credential is valid and has not expired.
    • Not Found / 404 errors: Verify that the tenant ID provided exists and is correct.
    • Timeouts or network errors: Ensure the API URL is reachable and there are no firewall restrictions.

Links and References

Discussion