# ForgeMesh x402 Publisher Registration

> ForgeMesh x402 Publisher Registration is a paid API for AI agents from ads.forgemesh.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Registers an x402 service as a publisher on the ForgeMesh ad network and returns a one-time publisher key, publisher ID, wallet address, and terms version.

## Facts

- Endpoint: GET https://ads.forgemesh.io/v1/publishers/register
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-x402-publisher-registration-5fdda859
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2-J8DpFzQnpS3Xr5aNpS0

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 forgemesh-x402-publisher-registration-5fdda859
```

Example prompt: Register my x402 service with ForgeMesh so I can get a publisher ID and key to start receiving intent reports and event analytics for my API.

## When to prefer this

Use this endpoint when you need to register a new x402 service on the ForgeMesh publisher network for the first time. This is the entry point for any publisher wanting to access ForgeMesh's agent intent analytics, event reporting, and demand signal data. It is not suitable for retrieving existing credentials (those are shown only once at registration) or for querying analytics without already being registered.

## Known failure modes

- Service already registered — duplicate registration may return an error or new conflicting credentials
- Network or registry unavailability causing a 5xx response
- Payment failure — the $0.1 USDC x402 payment not processed, blocking the registration
- Invalid or missing required headers/query parameters resulting in a 4xx error
- Key not stored before response is lost — publisher_key is shown only once and cannot be recovered

## How this service works

Registers your x402 service and returns a publisher_id, publisher_key, wallet, and terms version. The key unlocks free event reporting and intent reports on your own service. No placement guarantee — registry health and reputation apply. Store the key securely; it is shown once.

## Output

Returns a JSON object containing a unique publisher_id, a one-time publisher_key (shown only once — must be stored securely), a wallet address associated with the publisher account, and the current terms_version accepted at registration.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "wallet": {
       "type": "string"
      },
      "publisher_id": {
       "type": "string"
      },
      "publisher_key": {
       "type": "string"
      },
      "terms_version": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "wallet": "0x…",
  "publisher_id": "api-example-com",
  "publisher_key": "pub_…shown once…",
  "terms_version": "1.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-x402-publisher-registration-5fdda859/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ads.forgemesh.io](https://www.zero.xyz/host/ads.forgemesh.io/llms.txt)