# Vaaya Zep User Add

> Vaaya Zep User Add is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Adds a new user to Zep memory store via the Vaaya agent platform, enabling persistent user context for AI agents.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/zep/user-add
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-zep-user-add-8cf3304e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IulEh6YfAruPY3Uv-u6VP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vaaya-zep-user-add-8cf3304e -d '<json body>'
```

Example prompt: Add a new user to Zep memory with user ID 'usr_12345', first name 'Alice', last name 'Johnson', and email 'alice@example.com' so my agent can remember her across sessions.

## When to prefer this

Use this endpoint when you need to initialize persistent user memory in Zep through the Vaaya platform without managing direct Zep API keys or accounts. Ideal for AI agent pipelines that require long-term user context, personalization, or memory across sessions, especially when already using Vaaya's agent infrastructure.

## Known failure modes

- Missing required user_id returns validation error
- Duplicate user_id may conflict with existing record
- Invalid email format may be rejected
- Network or upstream Zep service unavailability returns 5xx
- Malformed JSON body returns 400 bad request

## How this service works

Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.

## Output

Returns a confirmation object indicating the user was successfully created in the Zep memory store, typically including the created user record or an acknowledgement status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "user_id"
     ],
     "properties": {
      "email": {
       "type": "string"
      },
      "user_id": {
       "type": "string",
       "minLength": 1
      },
      "metadata": {
       "type": "object",
       "additionalProperties": {}
      },
      "last_name": {
       "type": "string"
      },
      "first_name": {
       "type": "string"
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-zep-user-add-8cf3304e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)