Actions15
Overview
This node interacts with the Cativa API to manage users. Specifically, for the "User" resource and the "Add Badge to User" operation, it allows you to assign a badge to a user identified by their email address. This is useful in scenarios where you want to automate user recognition or achievements within your application or community platform.
Practical examples:
- Automatically award badges to users after completing onboarding.
- Assign special badges to users who participate in specific events.
- Integrate with other workflows to recognize user milestones.
Properties
| Name | Meaning |
|---|---|
| The email address of the user to whom the badge will be assigned (e.g., [email protected]). | |
| Badge ID | The unique identifier of the badge to add to the specified user. |
Output
The output is a JSON object (or array of objects) representing the result of the badge assignment operation. The structure typically includes:
- Confirmation of the badge assignment.
- Any relevant details returned by the Cativa API about the user or badge.
If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.
Dependencies
- External Service: Requires access to the Cativa API.
- API Credentials: You must configure valid Cativa API credentials in n8n under the name
cativaApi.
Troubleshooting
Common issues:
- Invalid Email or Badge ID: If the provided email or badge ID does not exist, the API may return an error.
- Authentication Errors: If the API credentials are missing or incorrect, authentication will fail.
- Network Issues: Connectivity problems can prevent successful API requests.
Error messages:
"Authentication successful": Indicates credentials are valid.- Error messages from the API (e.g., "User not found", "Badge not found") will appear in the output if "Continue On Fail" is enabled, otherwise they will stop the workflow.
How to resolve:
- Double-check the email and badge ID values.
- Ensure that the Cativa API credentials are correctly configured in n8n.
- Verify network connectivity to the Cativa API endpoint.
Links and References
- n8n Documentation
- (If available) Cativa API documentation – refer to your service provider for API reference.