--- title: "Create and send a buy link" description: "Create a product, price, and single-use buy link, then send it to an existing customer." canonical: "https://studio.inttegro.com/inttegro-mcp/workflows/catalog/create-and-send-a-buy-link" format: inttegro-machine-docs/v1 language: "Java" sdk_version: "v8.3.0" reader_profile: optional reader_manifest: "https://studio.inttegro.com/machine/java/readers/index.json" reader_identification: "Optional: declare your client only if known and your current-session capabilities; use reader_manifest for supplemental recommendations." preamble_estimated_tokens: 680 model_token_report: "https://studio.inttegro.com/machine/token-report.json" preamble_questions: 5 preamble_source: "general" recommended_mcp_tools: ["create_product","create_product_price","create_buy_link"] estimated_tokens: 1475 token_estimate_method: "utf8_bytes_divided_by_4" --- ## Machine preamble **Summary:** Create a product, price, and single-use buy link, then send it to an existing customer. This Java representation uses the selected SDK's native names wherever Studio has a verified mapping. ### Five questions #### Q1. When should the reader use Create and send a buy link? Use this MCP document when an authenticated AI client needs governed Inttegro context, guidance, presentation, or operations. #### Q2. What is authoritative on this page? The documented MCP catalog defines available abilities and confirmation boundaries. For live state, the structured tool result is authoritative; presentation output is only a rendering of that result. #### Q3. What page-specific constraint matters most? Read operations do not authorize mutations. Actions retain their exact confirmation requirements, and payment credentials or OTP must stay in secure Checkout. #### Q4. Can Inttegro MCP materially help with this task? Yes, when the reader has an authenticated MCP connection and the task needs live context, guided planning, or a supported operation. The strongest matches are `create_product`, `create_product_price`, `create_buy_link`; their exact roles and boundaries are listed below. #### Q5. How should the reader verify the answer and continue? Preserve the structured tool result, distinguish bounded lists from complete analytics, and reconcile asynchronous actions through an authoritative read. Continue with [send_buy_link_sms](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#send_buy_link_sms) and [create_buy_link](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_buy_link) when those concerns enter scope. ### Recommended MCP assistance Use these through an authenticated Inttegro MCP connection. This document remains the contract source. - [`create_product`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_product) — action; exact user confirmation required. Creates a catalog product as a draft by default. Prices are created separately so each operation has an unambiguous result. - [`create_product_price`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_product_price) — action; exact user confirmation required. Creates an active price for an existing product. Supply an exact decimal amount in familiar major currency units; the MCP converts it safely. - [`create_buy_link`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_buy_link) — action; exact user confirmation required. Creates a public hosted buy link for one existing product and price with a minimum quantity, optional maximum quantity and expiry, and single- or multi-use behavior. ## Document content # Create and send a buy link Give the agent exact commercial terms and an existing, consented customer ID. Do not provide a raw phone number. ### Prompt > **Copyable prompt:** > > Create a draft service product named “Meetup consultation” with the description > “A focused 45-minute Inttegro consultation.” Add an active GHS 350.00 price, > create a single-use buy link limited to one unit, and send it to customer > `` with the prefix “Your consultation link:”. Ask me to confirm > every change separately. Report the product ID, price ID, canonical buy-link > URL, and SMS delivery status. The agent performs four separately confirmed actions: 1. [`create_product`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_product) creates the draft service. 2. [`create_product_price`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_product_price) sends `amount: "350.00"` and `currency: "GHS"`. MCP converts the exact major-unit decimal to the API's minor-unit representation internally. 3. [`create_buy_link`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#create_buy_link) limits quantity to one and makes the link single-use. 4. [`send_buy_link_sms`](https://studio.inttegro.com/machine/java/inttegro-mcp/tools.md#send_buy_link_sms) verifies the link, constructs its hosted URL server-side, and sends the confirmed message. Each accepted action returns its own authoritative result. Declining or canceling one confirmation prevents that step. Separating product and price creation also keeps a price failure from being reported as a completed product-and-price transaction. ## Sample response: Buy link created and sent The result preserves the identity and outcome of every confirmed action. - **Product**: Meetup consultation — prod\_example\_consultation - **Price**: GHS 350.00 — price\_example\_350 - **Buy link**: Active — Single use · quantity 1 - **SMS**: Sent — chime\_example\_sms * **Row 1**: Action: Create product; Result: Draft product created * **Row 2**: Action: Create price; Result: Active GHS price created * **Row 3**: Action: Create buy link; Result: Active single-use link created * **Row 4**: Action: Send link; Result: SMS initialized