> For the complete documentation index, see [llms.txt](https://docs.tiun.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tiun.io/guides/getting-started/creating-first-product.md). # Create your first product Every tiun integration is wired to one or more **products** you configure in the dashboard. This guide walks through creating a product end-to-end and captures the **product ID** you'll use in code. *** ## 1. Open Products In the [my.tiun.business dashboard](https://my.tiun.business/), go to **Products**. The catalog belongs to whichever environment the **Sandbox** toggle is showing — live and sandbox each have their own products and IDs. Most teams create products in **sandbox** first while integrating, then recreate them in **live** when shipping. *** ## 2. Pick a product type Start a new product and choose the type that matches what you're selling. tiun supports three: * **Subscription** — you charge a flat recurring fee on a schedule (monthly, quarterly, yearly). Best when the value is access to the product itself over time. * **One-time purchase** — you charge a single fixed fee and access never expires. Best for consulting engagements, lifetime licenses, or a single course, report, or deliverable. * **Time-based** — you charge for the time the user spends with your content. Best for media-style products (articles, audio, video) where engagement varies per visit. If you're not sure, see [Products](/reference/generic/products.md) in Reference for a fuller comparison. *** ## 3. Configure pricing The configuration depends on the product type. Here's what each field actually represents — you'll be asked for the relevant ones during creation. **For a subscription product:** * **Name** — what the user will see (for example "Pro", "Light"). * **Recurring fee** — the amount charged each cycle. * **Billing interval** — how often the fee is charged (monthly, quarterly, yearly). * **Trial period** (optional) — a window where the user has access at a reduced price, including `0` for a free trial. **For a one-time product:** * **Name** — what the user will see (for example "Full course", "Lifetime license"). * **Fixed fee** — the single amount charged at checkout. The fee incurs only once; there's no interval and no trial. **For a time-based product:** * **Name** — internal label for the product. * **Interval** — the smallest billable unit of time (for example one minute). * **Interval fee** — what one interval costs. * **Monthly limit** — caps the total charge per month so heavy users don't run up surprise bills. Field semantics live in the [Products](/reference/generic/products.md) reference if you want the full picture. *** ## 4. Pick a tax category Whatever the type, you also file the product under a **tax category**. It's required and there's no default. tiun is the Merchant of Record for your sales, so this is what determines how the product is taxed. The form lists the available categories with a short description, guidance on where each one ends, and examples. Pick the one your product **genuinely** belongs to — not the closest-looking match. If none of them fit what you sell, choose **Something else** and describe your product. tiun follows up with you instead of filing it under an approximate category, so it's always better than picking a near-match. {% hint style="info" %} **The option "Something else" lives in this form only.** It's part of creating a product in the dashboard at [my.tiun.business](https://my.tiun.business/) — it is not available over the [MCP server](/guides/agent-integration/agent-integration.md), so an agent can't pick it for you. If you're setting products up through an agent and none of the categories fit, submit the missing category here in the dashboard instead. {% endhint %} {% hint style="warning" %} **Choose carefully — this one is permanent.** Unlike the name and price, a product's tax category cannot be changed after the product is created. Correcting it means archiving the product and creating a new one, and archiving cannot be undone. If you're unsure which category applies, use **Something else** rather than guessing. {% endhint %} *** ## 5. Save and copy the product ID Once the product is saved, copy its **product ID** — it's prefixed `p-test-...` in sandbox and `p-live-...` in live. Use it with the matching SDK environment (`sandbox: true` for `p-test-...`, live default for `p-live-...`). See [Sandbox](/reference/generic/sandbox.md) if you need both environments. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.tiun.io/guides/getting-started/creating-first-product.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.