{"uid":"cap_2-J8DpFzQnpS3Xr5aNpS0","slug":"forgemesh-x402-publisher-registration-5fdda859","name":"ForgeMesh x402 Publisher Registration","description":"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.","url":"https://ads.forgemesh.io/v1/publishers/register","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"type":"json","example":{"wallet":"0x…","publisher_id":"api-example-com","publisher_key":"pub_…shown once…","terms_version":"1.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jDT_9nJ1mHhJVbH0YiDFx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Bootstrap x402 API publisher account","prompt":"Register my x402 service with ForgeMesh and give me my publisher ID and key so I can start tracking which AI agents are hitting my endpoints."},{"title":"Unlock free event reporting for API","prompt":"I just launched an x402 API and I want to enroll it in ForgeMesh to get free event reporting — can you register it and save the publisher key they give me?"},{"title":"Onboard new service to ForgeMesh network","prompt":"Sign up my new x402 service on the ForgeMesh publisher registry so I can access the intent and demand analytics dashboard — I need that one-time publisher key stored safely."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:58.149Z","isFirstParty":false}