{"uid":"cap_C403DxvMU6LRhPOtUmbnq","slug":"inbox-withzero-xyz-present-buyer-link-code-merge-channel-into-buyer-cfa27f36","name":"Present Buyer Link Code (Merge Channel into Buyer Account)","description":"Present a link code minted on another channel: merges this channel into that buyer account. 📖 Full guide: https://inbox.withzero.xyz/llms.txt","url":"https://inbox.withzero.xyz/api/v1/buyer/links","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["code"],"properties":{"code":{"type":"string","minLength":1}},"additionalProperties":false},"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["linked","buyer_id","channel"],"properties":{"linked":{"type":"boolean","const":true},"channel":{"type":"string"},"buyer_id":{"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":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_x4uKV09c-nQTMeRBvgpDo","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"inbox.buyer_link:1"}],"brandName":"inbox.withzero.xyz","brandSlug":"inbox-withzero-xyz-mpp","brandBaseUrl":"https://inbox.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Accepts a single-use link code minted on another channel to merge the current channel into that buyer account on the inbox.withzero.xyz message bus.","exampleAgentPrompt":"I have a link code 'ABC123XYZ' that was minted on my other channel — use it to merge this channel into that buyer account on the inbox service.","exampleUseCases":[{"title":"Consolidate multiple agent channels into one account","prompt":"I'm managing chatbots across three different platforms and I want them all linked to the same buyer account. My main channel generated this link code 'LINK9K7M2' — can you redeem it here to merge all my agent channels together?"},{"title":"Reconnect after switching messaging platforms","prompt":"I'm migrating my customer support from one messaging platform to another, but I want to keep the same buyer identity. I have the code 'XZ8BRIDGE' from my old channel — please use it to connect my new channel to my existing buyer profile."},{"title":"Unify separate team channels under one identity","prompt":"Our sales and support teams are using separate agent channels, but they should be under the same buyer account for unified inbox management. I've got the code 'TEAM5RC1' from the sales channel — can you link this support channel to that same buyer account?"}],"resultDescription":"Returns a JSON object confirming the merge with fields: `linked` (boolean, always true on success), `buyer_id` (the unified buyer account ID), and `channel` (the channel identifier that was linked).","failureModes":["Expired code: link codes are only valid for 10 minutes after minting; returns error if expired","Invalid or already-used code: single-use codes cannot be redeemed twice","Code not found: if the code string is malformed or does not exist","Missing required field: request body missing `code` field returns 400 validation error","Channel already linked: this channel may already be associated with a buyer account"],"whenToPreferThis":"Use this endpoint when you have received a single-use link code minted by another channel (via the mint-link-code endpoint) and want to merge the current channel into that existing buyer account. This is the second step in a two-step channel-linking flow — first mint a code on the source channel, then redeem it here on the target channel.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-07-29T00:21:22.435Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:30.287Z","isFirstParty":true}