Actions3
- Report Actions
- Dashboard Actions
- Timeline Actions
Overview
This node integrates with the Reportei API to create reports, dashboards, and timelines for projects managed within Reportei. Specifically, the "Create a Report" operation allows users to generate a detailed report based on selected projects, integrations, templates, and defined analysis periods. This is useful for automating report generation workflows, consolidating data from multiple integrations, and scheduling periodic reporting.
Practical examples include:
- Automatically generating weekly or monthly performance reports for marketing projects.
- Creating customized reports using predefined templates to standardize output.
- Comparing current period data against previous periods to analyze trends.
Properties
| Name | Meaning |
|---|---|
| Project Name or ID | Select the project in which you want to create the report. You can choose from a list of projects or specify a project ID via an expression. |
| Integration Names or IDs | Select one or more integrations to include in the report. Options depend on the chosen project and can be selected from a list or specified by IDs using expressions. |
| Template Name or ID | (Optional) Choose a template to apply to the report. Templates help format and structure the report content. Can be selected from a list or specified by ID via expression. |
| Title | Define a custom title for the report. |
| Subtitle | Define a subtitle for the report to provide additional context or description. |
| Analysis Start | Specify the start date/time for the analysis period covered by the report. |
| Analysis End | Specify the end date/time for the analysis period covered by the report. |
| Comparison Period Start | Specify the start date/time for the comparison period, allowing side-by-side analysis with the main analysis period. |
| Comparison Period End | Specify the end date/time for the comparison period. |
Output
The node outputs JSON data representing the response from the Reportei API after creating the report. The JSON typically includes details about the newly created report such as its ID, status, and any metadata returned by the API.
If the operation fails or no valid operation is performed, the output JSON will contain an error message or a notification indicating no action was taken.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Reportei API.
- The node makes HTTP requests to Reportei endpoints to fetch projects, integrations, templates, and to create reports.
- Proper configuration of the API authentication credential in n8n is necessary.
- Network access to
https://app.reportei.com/api/v1/is required.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication failures.
- Selecting a project or integration that does not exist or is inaccessible may result in errors.
- Providing invalid date ranges (e.g., start date after end date) could cause API rejections.
- Using a template ID that is not available for the selected project might lead to errors.
Error messages:
"Unable to load templates"indicates failure to retrieve templates, possibly due to network issues or incorrect project ID.- API errors returned from the Reportei service will be passed through; check the error message for details.
Resolutions:
- Verify API credentials and permissions.
- Ensure project and integration selections are valid and accessible.
- Double-check date inputs for logical correctness.
- Confirm template availability for the selected project.
Links and References
- Reportei API Documentation (general reference for API endpoints)
- n8n Expressions Documentation (for specifying dynamic values in properties)