Produkte und Dateien

Create product

Als Markdown anzeigen Rohes Markdown in neuem Tab In ChatGPT öffnen Zu dieser Seite befragen In Claude öffnen Zu dieser Seite befragen

POST / v1 / products

Creates a product as a draft, so buyers cannot see it yet. You set the type, name, price and billing, sales page text, images, content and settings.

The type decides what buyers get:

download: content blocks (texts, images, videos, audio, files, video links, buttons).
link: a link_url and/or an access_text_html after the purchase.
newsletter: a sign-up for the email list, free or paid.
external: sold on another site, at external_url.
course: sells a course. Create the course with POST /v1/courses first, then give its course_id. To sell the same course again, use the same course_id. Do not create a copy.
bundle: other products together, in bundle_items.

download, link and course can have variants. Bookings can only be created in the Tentary app.

Images and the banner are copied from their URLs. A YouTube link in images shows as a video.
For files, call POST /v1/files first and use the file_id in a file block.
To publish, call PATCH /v1/products/{product_id} with status live.

Ändert sofort MCP-Werkzeug create_product

curl -X POST "https://api.tentary.com/v1/products" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "download",
  "name": "Yoga Workbook",
  "price": 24,
  "description_html": "<p>Plan your practice for 12 weeks.</p>",
  "content": [
    {
      "type": "file",
      "file_id": 601,
      "name": "Yoga Workbook",
      "description": "PDF to print, 40 pages."
    }
  ]
}'

const response = await fetch("https://api.tentary.com/v1/products", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "type": "download",
    "name": "Yoga Workbook",
    "price": 24,
    "description_html": "<p>Plan your practice for 12 weeks.</p>",
    "content": [
      {
        "type": "file",
        "file_id": 601,
        "name": "Yoga Workbook",
        "description": "PDF to print, 40 pages."
      }
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/products",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "type": "download",
        "name": "Yoga Workbook",
        "price": 24,
        "description_html": "<p>Plan your practice for 12 weeks.</p>",
        "content": [
            {
                "type": "file",
                "file_id": 601,
                "name": "Yoga Workbook",
                "description": "PDF to print, 40 pages.",
            },
        ],
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/products');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'type' => 'download',
        'name' => 'Yoga Workbook',
        'price' => 24,
        'description_html' => '<p>Plan your practice for 12 weeks.</p>',
        'content' => [
            [
                'type' => 'file',
                'file_id' => 601,
                'name' => 'Yoga Workbook',
                'description' => 'PDF to print, 40 pages.',
            ],
        ],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "id": 105,
  "name": "Yoga Workbook",
  "type": "download",
  "status": "draft",
  "url": "https://lena-yoga.mytentary.com/p/d2hpTs",
  "admin_url": "https://app.tentary.com/products/edit/105",
  "note": "The product is a draft: buyers cannot see it. Set status live to publish it."
}

Autorisierung

Authorization string Header erforderlich

Bearer tnt_… · A personal API key (tnt_...). Create it in the Tentary app on the page AI & API. Einführung

Body application/json

type string erforderlich

The product type (see above). update_product cannot change it.

Mögliche Werte: downloadlinknewsletterexternalcoursebundle
name string erforderlich

Product name.

min. Länge 1 max. Länge 255
price number | string

Amount in the account currency, like 49 or 19.99. 0 = free. Paid prices start at 1.00. For external: the price shown on the card.

min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
billing string

Default one_time.

Mögliche Werte: one_timesubscription
billing_interval_months integer

subscription: months between payments, default 1.

min. 1 max. 12
intro_price number | string

subscription: price of the first period, less than price.

min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
installment_plans array of object

one_time: payment plans that buyers can choose. [] removes them.

max. Einträge 5
2 Felder anzeigen Felder ausblenden
- count integer erforderlich
  
  min. 2 max. 100
- amount number | string erforderlich
  
  Per installment. Amount in the account currency, like 49 or 19.99.
  
  Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
compare_at_price number | string

one_time: crossed-out old price, higher than price. While a limited_offer runs, price is the crossed-out price instead; compare_at_price shows again when the offer ends.

Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
limited_offer object

one_time: a lower price for a time. While it runs, the sales page and the checkout show price crossed out and the offer price. Times with a zone; convert the seller's local time with timezone from get_account_overview.
4 Felder anzeigen Felder ausblenden
- price number | string erforderlich
  
  Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
- starts_at string erforderlich
  
  Like 2026-11-26T23:00:00Z.
- ends_at string erforderlich
  
  Like 2026-11-30T22:59:00Z.
- countdown object kann null sein
  
  A countdown to ends_at on the sales page and the checkout while the offer runs (made by JavaScript in the browser). null = none. Left out = unchanged. An object replaces the whole countdown.
  4 Felder anzeigen Felder ausblenden
  
  style string erforderlich
  
  classic and slim: a bar at the top (sticky: it stays while buyers scroll). card_*: a box next to the price.
  
  Mögliche Werte: classicclassic_stickyslimslim_stickycard_classiccard_slimcard_special_1
  
  text string kann null sein
  
  Short text in the countdown, like "Launch price ends in".
  
  max. Länge 255
  
  color string
  
  Background, hex like #ff4400 (default).
  
  secondary_color string kann null sein
  
  Bars: the text color (default white). Cards: the card background (default #1a1a1a).
description_html string

Sales page text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote; a with class "button" is a button). The page always has its own buy button. A buy button in the text links to the url of the product + "/checkout" (create_product and get_product give url); there is no #buy anchor.

max. Länge 200000
checkout_description_html string

Extra text only on the checkout page, HTML. Not for external.

max. Länge 20000
checkout_banner_url string

Banner image only on the checkout page, above the product title (it replaces the small product image). Recommended 1200 x 300 px. The image_url from finish_image, or a public image URL that Tentary copies. Not for external.

max. Länge 2048
images array of string

Product images on the sales page as https URLs: the image_url from finish_image (for an image on your disk), or a public image URL that Tentary copies (PNG, JPG, GIF, WebP, at most 10 MB). The first is the cover. YouTube links show as video. Replaces all images.

max. Länge 2048 max. Einträge 20
content array of object

download: what buyers get, in order. booking: what buyers get in addition to the appointment. Replaces all content.

max. Einträge 100
8 Felder anzeigen Felder ausblenden
- type string erforderlich
  
  text: formatted text. image: shows the image. video: an uploaded video in the player (streamed, converted some minutes after its first use). audio: an audio player. file: a download. video_embed: a YouTube, Vimeo or Loom video. button: a link button. image, video, audio and file need file_id. Type, name and description are stored with the file: one file shows the same way in every product and lesson.
  
  Mögliche Werte: textimagevideoaudiofilevideo_embedbutton
- html string
  
  text: the text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote). Placeholders for the buyer: %FIRST_NAME%, %FULL_NAME%, %EMAIL%, %PRODUCT_TITLE%, %VARIANT_TITLE%, %ORDER_ID%, %ACCESS_LINK[Text]%, %ACCESS_LINK_BUTTON[Text]%, %SELLER_NAME%, %SELLER_SUPPORT_EMAIL%; bookings also %ORDER_BOOKING_FROM%, %ORDER_BOOKING_TO%, %ORDER_BOOKING_ZOOM_LINK%.
  
  max. Länge 65535
- url string
  
  video_embed: YouTube, Vimeo or Loom link. button: the link target.
  
  max. Länge 2048
- label string
  
  button: the button text.
  
  max. Länge 250
- file_id integer
  
  image, video, audio, file: a file from upload_file, or a file_id from get_product or get_lesson content.
  
  min. 1
- name string
  
  image, video, audio, file: the name of the file (file: shown above the download).
  
  min. Länge 1 max. Länge 250
- description string
  
  file: plain text under the download. audio: the title above the player.
  
  max. Länge 65535
- folder string kann null sein
  
  Optional folder name. Blocks with the same folder show together. Not in lessons.
  
  max. Länge 250
link_url string

link: the link that buyers get.

max. Länge 2048
access_text_html string

link: text that buyers see after purchase. bundle: extra details for the buyers. HTML. Takes the placeholders of text blocks.

max. Länge 65535
bundle_items array of object

bundle: the products that buyers get, from list_products (live or draft; no bundles or bookings). For a product with variants, give the variant_id of one variant. Replaces the list. Needed to go live.

max. Einträge 100
2 Felder anzeigen Felder ausblenden
- product_id integer erforderlich
  
  min. 1
- variant_id integer kann null sein
  
  Only for a product with variants.
  
  min. 1
external_url string

external: where buyers buy it.

max. Länge 2048
course_id integer

course: the course that buyers get (from list_courses or create_course). Needed to go live.

min. 1
variants array of object

download, link and course: options that buyers choose at checkout, each with its own name, price, stock and content (download: content, link: link_url and access_text_html, course: course_id). Replaces the list: a variant with id stays and changes (fields that you leave out stay), one without id is new, a variant that is not in the list is removed (its buyers keep access). [] or null removes all variants. With variants, price is the lowest variant price; billing must be one_time, without installment_plans, limited_offer and compare_at_price; a download product has no content of its own.

max. Einträge 50
8 Felder anzeigen Felder ausblenden
- id integer
  
  An existing variant (from get_product). Leave out for a new variant.
  
  min. 1
- name string
  
  Needed for a new variant.
  
  min. Länge 1 max. Länge 255
- price number | string
  
  Amount in the account currency, like 49 or 19.99. 0 = free. Needed for a new variant.
  
  min. 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
- stock_limit integer kann null sein
  
  How many can be sold. null or 0 = no limit.
  
  min. 0
- content array of object
  
  download: what buyers of this variant get. Replaces its content.
  
  max. Einträge 100
  8 Felder anzeigen Felder ausblenden
  
  type string erforderlich
  
  text: formatted text. image: shows the image. video: an uploaded video in the player (streamed, converted some minutes after its first use). audio: an audio player. file: a download. video_embed: a YouTube, Vimeo or Loom video. button: a link button. image, video, audio and file need file_id. Type, name and description are stored with the file: one file shows the same way in every product and lesson.
  
  Mögliche Werte: textimagevideoaudiofilevideo_embedbutton
  
  html string
  
  text: the text as HTML (p, h1-h4, strong, em, ul, ol, li, a, img, blockquote). Placeholders for the buyer: %FIRST_NAME%, %FULL_NAME%, %EMAIL%, %PRODUCT_TITLE%, %VARIANT_TITLE%, %ORDER_ID%, %ACCESS_LINK[Text]%, %ACCESS_LINK_BUTTON[Text]%, %SELLER_NAME%, %SELLER_SUPPORT_EMAIL%; bookings also %ORDER_BOOKING_FROM%, %ORDER_BOOKING_TO%, %ORDER_BOOKING_ZOOM_LINK%.
  
  max. Länge 65535
  
  url string
  
  video_embed: YouTube, Vimeo or Loom link. button: the link target.
  
  max. Länge 2048
  
  label string
  
  button: the button text.
  
  max. Länge 250
  
  file_id integer
  
  image, video, audio, file: a file from upload_file, or a file_id from get_product or get_lesson content.
  
  min. 1
  
  name string
  
  image, video, audio, file: the name of the file (file: shown above the download).
  
  min. Länge 1 max. Länge 250
  
  description string
  
  file: plain text under the download. audio: the title above the player.
  
  max. Länge 65535
  
  folder string kann null sein
  
  Optional folder name. Blocks with the same folder show together. Not in lessons.
  
  max. Länge 250
- link_url string kann null sein
  
  link: the link that buyers of this variant get.
  
  max. Länge 2048
- access_text_html string kann null sein
  
  link: text that buyers of this variant see after purchase, HTML. Takes the placeholders of text blocks.
  
  max. Länge 65535
- course_id integer
  
  course: the course that buyers of this variant get. Needed for a new variant.
  
  min. 1
marketing_emails boolean

Subscribe buyers to the marketing e-mails (always on for newsletter).
ebook boolean

Treat as e-publication (e-book) for VAT.
pdf_stamp boolean

Stamp PDFs with the buyer's e-mail address.
login_protection boolean

Buyers must log in to open the product.
show_in_search boolean

Show the sales page in Google.
hide_in_shop boolean

Do not show the product on the shop page.
coupon_field boolean

Show the coupon field at checkout (default true).
stock_limit integer

How many can be sold. null or 0 = no limit.

min. 0
buy_button_text string

Text of the buy button. Empty = default.

max. Länge 30
url_slug string

Own URL part: shop URL/p/<url_slug>. Lowercase letters, digits and hyphens.

max. Länge 120
access_days integer

Access ends this many days after purchase (3 to 9999). null or 0 = no end.

min. 0 max. 9999
access_starts_on string

Buyers get access from this day at the earliest (for example the start of a program). Before it they wait. null = at once. Not for newsletter and external.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
lead_magnet boolean

A free product that grows the e-mail list: buyers first confirm the marketing e-mails, then they get the product. Needs price 0 and billing one_time, and turns on marketing_emails. Not for newsletter, booking and external.
withdrawal_days integer

Withdrawal period shown at checkout.

Mögliche Werte: 01430
available_from string

First day of sale.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
available_until string

Last day of sale.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

Antwort

Felder der Antwort mit Status 200. Fehler haben immer dasselbe Format, siehe Fehler.

The short form. get_product has all fields.

id integer

The ID.
name string

The name.
type string

The type.

Mögliche Werte: downloadlinknewsletterbookingcoursebundleexternal
status string

archived = deleted.

Mögliche Werte: livedraftarchived
url string<uri>

Sales page.
admin_url string<uri>

The page in the Tentary app.
note string

What to do next.