Cativa Trigger icon

Cativa Trigger

Start workflow when an event occurs

Actions3

Overview

The Cativa Trigger node for n8n is designed to start workflows when specific events related to users occur in the Cativa system. Specifically, with the "User" resource and the "New Badge Users" operation, this node monitors for users who have received a new badge. It can fetch users based on different criteria (e.g., from now, from a specific ID, or all users). This is useful for automating actions such as sending notifications, updating records, or triggering follow-up processes whenever a user earns a new badge.

Practical examples:

  • Automatically send a congratulatory email when a user receives a new badge.
  • Add users with new badges to a CRM or mailing list.
  • Trigger internal alerts or analytics updates when badge achievements occur.

Properties

Name Meaning
Initial Data Determines how to fetch users:
- From Now: Only users who receive a badge after the workflow starts.
- From ID: Start from a specific user ID.
- All: Fetch all users with the badge.
From ID The specific user ID from which to start fetching new badge users. Only required if "Initial Data" is set to "From ID".
Badge ID The identifier of the badge to monitor for new users.

Output

The output is an array of JSON objects, each representing a user who has received the specified badge. Each object contains user details as provided by the Cativa API. The exact structure depends on the API response, but typically includes fields like:

{
  "id": "string",
  "shortId": { "guid": "string" },
  "createdAt": "ISO8601 timestamp",
  // ...other user-related fields
}
  • If multiple users are found, the output will be an array of such objects.
  • In manual mode, only the first matching user is returned.

Dependencies

  • External Service: Requires access to the Cativa API.
  • API Credentials: Needs a valid cativaApi credential configured in n8n.
  • n8n Configuration: No special environment variables beyond standard credential setup.

Troubleshooting

Common Issues:

  • Authentication errors: If credentials are incorrect or missing, the node will fail to connect to the Cativa API.
  • No data returned: If the "Badge ID" is incorrect or there are no users with the badge, the output will be empty.
  • Parameter errors: If "From ID" is required but not provided, the node may throw a validation error.

Error Messages & Resolutions:

  • "Authentication failed": Check your Cativa API credentials in n8n.
  • "Missing required parameter: Badge ID": Ensure you have entered a valid Badge ID.
  • "No users found": Confirm that users have actually received the specified badge.

Links and References

Discussion