# Citiview Webhook Inbox

> Citiview Webhook Inbox is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Create a temporary public webhook inbox URL for receiving POST messages, then read those messages using a token — retains up to 200 messages of 64 KB each for 7 days.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/inbox?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-webhook-inbox-7613f2dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hEoydpW7O3m4thS1nHY0V

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 citiview-webhook-inbox-7613f2dd
```

Example prompt: Create a new webhook inbox for me so I have a public URL that any service can POST to, and then read the messages that have come in using the token you got back.

## When to prefer this

Choose this endpoint when an agent or workflow needs a temporary, zero-setup public URL to receive incoming HTTP POST payloads from any external service — particularly useful for testing webhooks, capturing events from third-party platforms, or enabling agent-to-agent communication without standing up any server infrastructure. Prefer it over persistent message queues when short-lived retention (7 days, 200 messages) is sufficient and simplicity matters.

## Known failure modes

- Missing 'action' query parameter — request is rejected
- Invalid or expired token when reading — access denied or empty result
- Inbox ID not found or expired after 7 days — 404 or empty message list
- Message store full (200-message limit) — oldest messages may be dropped
- Malformed request body on POST to inbox — message may not be stored correctly

## How this service works

Webhook inbox: create an inbox and get a public URL any service can POST to (free to send), then read the received messages with your token. Keeps 200 messages, 64 KB each, for 7 days. Also callable as GET with the same fields as query parameters.

## Output

On 'create': returns a public inbox URL and an auth token used to read messages later. On 'read': returns the list of messages (up to 200) that have been POSTed to the inbox, optionally filtered to messages after a given sequence number. Each message can be up to 64 KB and is retained for 7 days.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "action"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "since": {
       "type": "integer",
       "description": "Only messages after this number"
      },
      "token": {
       "type": "string"
      },
      "action": {
       "type": "string",
       "description": "create | read"
      }
     }
    }
   },
   "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/citiview-webhook-inbox-7613f2dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)