Actions12
Overview
This node integrates with the Zep AI Memory Service to manage users, sessions, and memory data. Specifically for the User Create operation, it allows you to create a new user in the Zep system by providing user details such as a unique user ID, email, first name, last name, and optional metadata.
Common scenarios where this node is beneficial include:
- Registering new users in an AI-powered application that uses Zep for memory management.
- Synchronizing user information from other systems into Zep.
- Automating user creation workflows within n8n when onboarding new customers or clients.
For example, you could use this node to automatically create a user profile in Zep whenever a new customer signs up on your website, enabling personalized AI interactions tied to that user.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier for the user. This is required and used to identify the user in Zep. |
| The user's email address. Optional but useful for contact or identification purposes. | |
| First Name | The user's first name. Optional descriptive field. |
| Last Name | The user's last name. Optional descriptive field. |
| Metadata | Additional user-related data as a JSON object. Can store any extra information about the user. |
Output
The node outputs the response from the Zep API as JSON. For the "Create User" operation, this typically includes the created user's details as returned by the API, confirming successful creation.
The output is structured as an array of JSON objects, each representing the result of processing one input item. Each object contains the user data returned by the API.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Zep AI Memory Service.
- The node configuration must include the base URL of the Zep API and a valid API key.
- Network access to the Zep API endpoint is necessary.
Troubleshooting
Common issues:
- Missing or invalid API key will cause authentication failures.
- Providing an already existing user ID may result in an error or conflict response from the API.
- Malformed JSON in the Metadata property can cause parsing errors.
Error messages:
- Authentication errors typically indicate problems with the API key; verify the credential setup.
- Validation errors from the API may indicate missing required fields like User ID.
- JSON parse errors suggest incorrect formatting in the Metadata field; ensure valid JSON syntax.
To resolve these, double-check credentials, ensure all required fields are provided, and validate JSON inputs before running the node.
Links and References
- Zep AI Memory Service Documentation (for detailed API usage and user management)
- n8n HTTP Request Node Documentation (for understanding how API requests are made)