# Present Buyer Link Code (Merge Channel into Buyer Account)

> Present Buyer Link Code (Merge Channel into Buyer Account) is a paid API for AI agents from inbox.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: POST https://inbox.withzero.xyz/api/v1/buyer/links
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 3
- Provider: inbox.withzero.xyz
- Website: https://inbox.withzero.xyz
- Canonical page: https://www.zero.xyz/c/inbox-withzero-xyz-present-buyer-link-code-merge-channel-into-buyer-cfa27f36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C403DxvMU6LRhPOtUmbnq

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 inbox-withzero-xyz-present-buyer-link-code-merge-channel-into-buyer-cfa27f36 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Present a link code minted on another channel: merges this channel into that buyer account. 📖 Full guide: https://inbox.withzero.xyz/llms.txt

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "code"
 ],
 "properties": {
  "code": {
   "type": "string",
   "minLength": 1
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/inbox-withzero-xyz-present-buyer-link-code-merge-channel-into-buyer-cfa27f36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from inbox.withzero.xyz](https://www.zero.xyz/host/inbox.withzero.xyz/llms.txt)