Zep AI icon

Zep AI

AI Tool for interacting with Zep memory and knowledge graph. Provides operations to store/retrieve conversation memory, search knowledge graphs, and manage user context.

Actions9

Overview

The node "Zep AI" integrates with the Zep AI platform to manage conversation memory, knowledge graphs, and user context. Specifically, the Create User operation allows you to create a new user profile in the Zep system by providing user details such as user ID, email, first name, last name, and additional metadata.

This node is useful in scenarios where you want to programmatically register users into the Zep AI environment to later track their conversations, associate data with them, or personalize interactions based on stored user information.

Practical example:
You have a chatbot application and want to onboard new users into your knowledge graph system automatically. Using this node’s Create User operation, you can send user details collected from your app to Zep AI, creating a user profile that can be referenced in future operations like adding conversation memory or searching the knowledge graph.

Properties

Name Meaning
User ID The unique identifier for the user to create (e.g., "user-123").
Email The user's email address (optional).
First Name The user's first name (optional).
Last Name The user's last name (optional).
User Metadata Additional user metadata provided as a JSON object (optional). Used to store custom attributes.

Output

The output JSON object for the Create User operation includes:

  • success: Boolean indicating if the user creation was successful.
  • userId: The user ID provided in the input.
  • userCreated: The full response from the Zep API containing details about the created user.

Example output structure:

{
  "success": true,
  "userId": "user-123",
  "userCreated": {
    // Full user creation response from Zep API
  }
}

No binary data is output by this operation.

Dependencies

  • Requires an active connection to the Zep AI API endpoint (https://api.getzep.com).
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node uses HTTP POST requests to create users on the Zep platform.

Troubleshooting

  • Invalid JSON in user metadata:
    If the User Metadata field contains malformed JSON, the node will throw an error: "Invalid JSON in user metadata".
    Resolution: Ensure the JSON syntax is correct before running the node.

  • Missing required User ID:
    The User ID property is mandatory. Omitting it will cause the request to fail.
    Resolution: Always provide a unique string identifier for the user.

  • API authentication errors:
    If the API key or token is missing or invalid, the node will fail to authenticate with the Zep API.
    Resolution: Verify that the API credential is correctly set up in n8n and has proper permissions.

  • Network or API downtime:
    Temporary network issues or Zep service outages may cause request failures.
    Resolution: Retry after some time or check the Zep status page.

Links and References

Discussion