Cloudia icon

Cloudia

Send messages

Actions20

Overview

This node integrates with the Cloudia platform to manage customer-related operations, specifically allowing you to add tags to customers. It is useful in scenarios where you want to categorize or label customers dynamically within your workflows, such as segmenting customers by interest, status, or campaign participation.

For example, you might use this node to automatically tag a customer as "VIP" after they make a purchase or to add a "Newsletter Subscriber" tag when they sign up for updates.

Properties

Name Meaning
Cloudia API Key An API key string used for authentication if not using stored credentials.
Customer ID The unique numeric identifier of the customer to whom the tag will be added.
Tag ID The numeric identifier of the tag to add to the customer (optional alternative to Tag Name).
Tag Name The name of the tag to add to the customer.
Tag Color The HEX color code representing the tag's color (e.g., #ABF019).
Channel Integration ID The numeric ID of the channel integration through which messages are sent (required).
Name The customer's name to be sent along with the request (required).

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each object contains the response from the Cloudia API after attempting to add the tag to the specified customer.

If the operation fails and "Continue On Fail" is enabled, the output for that item will contain an error field with the error message.

No binary data is output by this node.

Dependencies

  • Requires access to the Cloudia API.
  • Needs either an API key provided directly via the "Cloudia API Key" property or configured credentials in n8n.
  • The node uses HTTP POST requests to Cloudia endpoints specific to customer operations.
  • Proper configuration of the "Channel Integration ID" is necessary to route messages correctly.

Troubleshooting

  • Common Issues:

    • Missing or invalid API key can cause authentication failures.
    • Incorrect Customer ID or Tag ID/Name may result in errors from the Cloudia API.
    • Not providing required fields like "Customer ID", "Channel Integration ID", or "Name" will cause validation errors.

  • Error Messages:

    • "Unsupported resource": Occurs if the selected resource is not recognized; ensure "Customer" is selected.
    • "Unsupported operation": Happens if the operation is not supported for the chosen resource; verify the operation is "Add Tag".
    • API errors returned from Cloudia will be passed through; check the error message for details such as invalid IDs or permission issues.

  • Resolution Tips:

    • Double-check all required fields are filled correctly.
    • Verify the API key has sufficient permissions.
    • Use the "Continue On Fail" option during testing to handle errors gracefully.

Links and References

Discussion