Overview
This node integrates with the CleverTap API to upload event data. It is designed to send batches of event objects formatted according to the CleverTap Upload API specification. This functionality is useful for analytics, user behavior tracking, and marketing automation scenarios where you want to push custom event data into CleverTap from n8n workflows.
A practical example would be uploading user interaction events collected from a website or app (like button clicks, page views, purchases) in bulk to CleverTap for further analysis and segmentation.
Properties
| Name | Meaning |
|---|---|
| Events JSON | An array of event objects formatted per the CleverTap Upload API. Each object represents an individual event to upload. |
Output
The node outputs the JSON response returned by the CleverTap API after uploading the events. The output structure is:
{
"json": {
// Response fields as returned by CleverTap API, e.g. success status, error messages, etc.
}
}
No binary data is produced by this operation.
Dependencies
- Requires an API key credential for CleverTap authentication, including account ID and passcode.
- The node makes HTTPS requests to the CleverTap API endpoint based on the configured region or base URL.
- No additional external dependencies beyond standard HTTP request capabilities.
Troubleshooting
Common issues:
- Malformed JSON in the "Events JSON" property can cause parsing errors. Ensure the input is valid JSON.
- Incorrect or missing API credentials will result in authentication failures.
- Network connectivity issues may prevent successful API calls.
Error messages:
- Errors thrown by the CleverTap API (e.g., invalid event format, unauthorized access) are passed through in the node's output if "Continue On Fail" is enabled.
- If not continuing on fail, the node execution stops and throws the error message received from the API or from internal validation.
Resolution tips:
- Validate the JSON structure before running the node.
- Verify that the API credentials are correctly set up in n8n.
- Check network access to CleverTap endpoints.
- Use the "Continue On Fail" option to handle partial failures gracefully.