CIPP icon

CIPP

Work with the CIPP API
Join our community

Actions7

Overview

This node interacts with the CIPP API to retrieve domain information associated with a specific tenant. It is useful in scenarios where you need to programmatically access and manage domain data tied to tenants within an organization or system that uses the CIPP platform. For example, it can be used to automate reporting on tenant domains, validate domain configurations, or integrate domain data into other workflows.

Properties

Name Meaning
Tenant Name or ID Select a tenant from a list or specify its ID using an expression. This identifies which tenant's domains to retrieve.

Output

The node outputs JSON data containing the domains related to the specified tenant. The exact structure depends on the CIPP API response but typically includes domain names and possibly additional metadata about each domain. There is no indication of binary data output.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API.
  • The base URL for the API is configured via credentials.
  • The node relies on the CIPP API endpoint /api to fetch tenant domain data.
  • The property tenantId uses a dynamic options loader method to populate tenant choices.

Troubleshooting

  • Common issues:
    • Invalid or missing API credentials will cause authentication failures.
    • Specifying an incorrect tenant ID or name may result in empty or error responses.
    • Network connectivity problems can prevent successful API calls.
  • Error messages:
    • Authentication errors indicate invalid or expired API tokens; reconfigure credentials.
    • "Tenant not found" or similar errors suggest the tenant identifier is incorrect; verify the tenant selection.
    • Timeout or connection errors require checking network access to the CIPP API endpoint.

Links and References

Discussion