# Convrgent Vault Profile Creator

> Convrgent Vault Profile Creator is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Creates a new persistent human personality profile in the Convrgent vault, namespaced to an agent's wallet address, seeded with identity data, text samples, observations, and birth data.

## Facts

- Endpoint: POST https://convrgent.ai/api/vault/create
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-43e4614a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hX478yn2L9w8-CYrT4U1Q

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 convrgent-ai-43e4614a -d '<json body>'
```

Example prompt: Create a new Convrgent vault profile for Alex Chen — here are some text samples from their messages, a few observations about their communication style, and their birth date is March 14 1988 in San Francisco.

## When to prefer this

Use this endpoint when you need to initialize a brand-new persistent human profile in the Convrgent vault before running any personality, astrology, or communication analysis. This is the entry point — call it first before using update, psychological profile, MBTI, Vedic astrology, or communication adaptation endpoints. Prefer this over the update endpoint when the person does not yet have an existing vault record.

## Known failure modes

- Duplicate profile creation for same identity — may conflict or require update endpoint instead
- Missing required identity or birth data fields — returns validation error
- Invalid wallet address namespace — authorization failure
- Malformed text samples or observations — parsing or ingestion error
- Insufficient USDC balance for $0.01 fee — payment failure via x402

## How this service works

Create a new persistent human profile in the vault. Agent-namespaced by wallet address. Accepts initial identity, text samples, observations, and birth data.

## Output

Returns a newly created persistent vault profile record for the specified human, namespaced to the calling agent's wallet address, containing the initial identity, text samples, observations, and birth data provided. Subsequent calls to analysis endpoints can reference this profile.

## Example request

```json
{
 "human_id": "alex_chen_sf_1988",
 "frame_type": "price-increase",
 "constraints": [
  "Emphasize service improvements and expanded features",
  "Acknowledge their loyalty and long-term partnership",
  "Provide 30-day notice period"
 ],
 "information": "We are implementing a new pricing structure that will increase costs by 15% effective next quarter",
 "kyh_profile": {
  "birthDate": "1988-03-14",
  "preferences": [
   "data-driven arguments",
   "transparency",
   "long-term partnerships"
  ],
  "birthLocation": "San Francisco",
  "communicationStyle": "direct and analytical"
 },
 "desired_outcome": "zero-qa@agentmail.to",
 "audience_context": "Long-term enterprise customer with data-driven decision-making preferences"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "required": [
      "human_id"
     ],
     "properties": {
      "name": {
       "type": "string"
      },
      "context": {
       "type": "object"
      },
      "human_id": {
       "type": "string",
       "description": "Agent-chosen unique identifier for this human"
      },
      "birthData": {
       "type": "object",
       "required": [
        "year",
        "month",
        "day",
        "location"
       ],
       "properties": {
        "day": {
         "type": "integer"
        },
        "hour": {
         "type": "integer",
         "description": "Highly recommended. Defaults to 12 if omitted."
        },
        "year": {
         "type": "integer"
        },
        "month": {
         "type": "integer"
        },
        "minute": {
         "type": "integer",
         "description": "Defaults to 0 if omitted."
        },
        "latitude": {
         "type": "number",
         "description": "Optional override"
        },
        "location": {
         "type": "string",
         "description": "City and country. Coordinates auto-resolved."
        },
        "timezone": {
         "type": "number",
         "description": "Optional — auto-resolved from location"
        },
        "longitude": {
         "type": "number",
         "description": "Optional override"
        }
       }
      },
      "textSamples": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "text"
        ],
        "properties": {
         "text": {
          "type": "string"
         },
         "context": {
          "type": "string"
         }
        }
       }
      },
      "observations": {
       "type": "object"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "created": true,
  "human_id": "alice-chen-001",
  "stored_signals": {
   "textSamples": 1,
   "observations": 0
  },
  "frameworks_computed": [
   "natal-chart",
   "communication"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-43e4614a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)