Zep Memory icon

Zep Memory

Interact with Zep AI Memory Service
Join our community

Actions20

Overview

This node integrates with the Zep AI Memory Service to manage user data among other resources. Specifically, for the User - Create operation, it allows you to create a new user in the Zep system by providing essential user details and optional metadata. This is useful in scenarios where you want to programmatically register users into the Zep AI platform, enabling personalized memory or session tracking tied to those users.

Practical examples include:

  • Automatically creating user profiles when onboarding customers from your CRM.
  • Syncing user information from external systems into Zep for AI-driven interactions.
  • Setting up users with custom metadata and instructions for fact rating to tailor AI responses.

Properties

Name Meaning
User ID The unique identifier for the user (required).
Email User email address.
First Name User first name.
Last Name User last name.
Partner ID Partner ID stored inside the user's metadata under partnerid.
User ID Meta Additional user ID metadata stored inside the user's metadata under userid.
Fact Rating Instruction JSON object with instructions for fact rating, e.g., {"high": "Very important", "medium": "Somewhat important", "low": "Less important"}.
Metadata Additional metadata as a JSON object to store any extra user-related information.

Output

The node outputs a JSON object representing the created user as returned by the Zep API. This typically includes the user ID, email, names, metadata, and any other relevant user details confirmed by the service.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Zep AI Memory Service.
  • The node uses the base URL and API key from these credentials to make HTTP requests.
  • Proper configuration of the API key credential in n8n is necessary before using this node.

Troubleshooting

  • Invalid or missing API key: The node will fail if the API key credential is not set or invalid. Ensure the API key is correctly configured.
  • Malformed JSON in metadata or fact rating instruction: If the JSON strings provided for metadata or factRatingInstruction are invalid, the request will fail. Validate JSON syntax before input.
  • Missing required fields: The User ID is mandatory; omitting it will cause errors.
  • API endpoint errors: Network issues or incorrect base URL settings can cause failures. Verify connectivity and credential settings.
  • Continue on Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error messages in the output JSON.

Links and References

Discussion