Cativa icon

Cativa

Consume Cativa API

Actions15

Overview

The Cativa node for n8n allows you to interact with the Cativa API. When using the User resource and the Send Private Message operation, this node sends a private message to a specified user via their email address. This is useful in scenarios where you need to automate direct communication with users, such as sending notifications, alerts, or personalized messages as part of your workflow.

Practical examples:

  • Automatically notify a user when a specific event occurs (e.g., order shipped, support ticket updated).
  • Send onboarding messages to new users.
  • Deliver custom alerts or reminders directly to a user's inbox.

Properties

Name Meaning
Email The recipient's email address. This is required to identify the user who will receive the private message. Example: [email protected]
Content The content of the private message to be sent. This is the body of your message.

Output

The output is a JSON object (or array of objects) representing the result of the send private message operation. While the exact structure depends on the Cativa API response, typical fields may include:

  • Confirmation of message delivery
  • Any error messages if the operation failed

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example output:

[
  {
    "success": true,
    "messageId": "12345",
    "recipient": "[email protected]"
  }
]

Or, in case of error (with continue on fail):

[
  {
    "error": "User not found"
  }
]

Dependencies

  • External Service: Requires access to the Cativa API.
  • API Credentials: You must configure the cativaApi credential in n8n for authentication.
  • n8n Configuration: No additional environment variables are required beyond the credential setup.

Troubleshooting

Common issues:

  • Invalid or missing credentials: If the cativaApi credential is not set up correctly, authentication will fail.
  • User not found: If the provided email does not correspond to a valid user, the API may return an error.
  • Missing required fields: Both "Email" and "Content" are required; omitting either will cause the node to throw an error.

Error messages:

  • "Authentication successful": Indicates credentials are valid.
  • "User not found": The email does not match any user in Cativa.
  • "Missing required parameter": One of the required properties was not provided.

How to resolve:

  • Double-check that the cativaApi credential is configured and valid.
  • Ensure the email address is correct and corresponds to an existing user.
  • Make sure all required fields are filled in the node configuration.

Links and References

  • n8n Documentation
  • (If available) Cativa API documentation – refer to your service provider for details.

Discussion