{"uid":"cap_RPdUx9WIkitN6aRVHH_Bk","slug":"inbox-withzero-xyz-mint-buyer-link-code-dea4dd5e","name":"Mint Buyer Link Code","description":"Mint a single-use code (10 min) that links another purchasing channel to this buyer account. 📖 Full guide: https://inbox.withzero.xyz/llms.txt","url":"https://inbox.withzero.xyz/api/v1/buyer/link-codes","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["code","expires_at","buyer_id"],"properties":{"code":{"type":"string"},"buyer_id":{"type":"string"},"expires_at":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_RIL5R7UDdbic_iZgXv-JG","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"inbox.buyer_link_code:1"}],"brandName":"inbox.withzero.xyz","brandSlug":"inbox-withzero-xyz-mpp","brandBaseUrl":"https://inbox.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Generates a short-lived (10-minute), single-use code that allows another purchasing channel to be linked to the current buyer account.","exampleAgentPrompt":"Generate a single-use link code so I can connect my email purchasing channel to my existing inbox.withzero.xyz buyer account — the code should be fresh and ready to present on the other channel.","exampleUseCases":[{"title":"Consolidate wallet and email purchases","prompt":"I need to link my Gmail address to my existing wallet-based buyer account so all my purchases show up in one place — can you generate a temporary code I can use to connect them?"},{"title":"Migrate purchases to new app","prompt":"I'm switching to a different shopping app but want to keep my purchase history. Generate a link code so I can merge my new app account with my current buyer profile."},{"title":"Add alternative payment method","prompt":"I want to set up Apple Pay as another way to buy through my existing account. Can you create a single-use code that lets me link this new payment channel to my current buyer ID?"}],"resultDescription":"Returns a JSON object containing: a single-use `code` string (valid for 10 minutes), the `expires_at` timestamp indicating when the code expires, and the `buyer_id` identifying the buyer account the code is tied to. The code can then be presented on another channel to merge it into this buyer account.","failureModes":["Authentication failure — invalid or missing signed proof credential returns 401","Buyer account not provisioned — if no inbox/buyer account exists yet, returns 404 or error","Rate limiting — too many codes minted in a short window may return 429","Expired or malformed request body returns 400"],"whenToPreferThis":"Use this endpoint when an agent or user needs to associate a new purchasing channel (e.g. email, another wallet, a different app) with an already-established buyer account on inbox.withzero.xyz. This is the minting side of the two-step link flow — call this first, then present the returned code on the other channel via the complementary 'present link code' endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:22.439Z","lastSuccessfullyRanAt":"2026-07-29T00:21:22.439Z","lastHealthCheckAt":"2026-09-15T06:30:15.600Z","isFirstParty":true}