Landingpages

Create landing page

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

POST / v1 / landing-pages

Creates a landing page from your own HTML code, at the shop URL plus /<url_slug>. It is a draft unless status is live.

A draft has no preview. Its URL opens the shop until the page is live.
Tentary serves your HTML as it is. It only adds what the account set up in the shop settings: tracking codes, the cookie banner, and the custom code if it is allowed for HTML pages.
Forms with data-tentary get their sign-up function.
The answer has the URL, but not the HTML. GET /v1/landing-pages/{page_id} returns the HTML.
Tentary does not store a change time.

Ändert sofort MCP-Werkzeug create_landing_page

curl -X POST "https://api.tentary.com/v1/landing-pages" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Free stretching guide",
  "url_slug": "stretching-guide",
  "html": "<!doctype html><html><body><h1>Free stretching guide</h1><form data-tentary=\"subscribe\"><input type=\"email\" name=\"email\"><button>Send it to me</button></form><p data-tentary=\"subscribed\">Check your inbox.</p></body></html>"
}'

const response = await fetch("https://api.tentary.com/v1/landing-pages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "title": "Free stretching guide",
    "url_slug": "stretching-guide",
    "html": "<!doctype html><html><body><h1>Free stretching guide</h1><form data-tentary=\"subscribe\"><input type=\"email\" name=\"email\"><button>Send it to me</button></form><p data-tentary=\"subscribed\">Check your inbox.</p></body></html>"
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/landing-pages",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "title": "Free stretching guide",
        "url_slug": "stretching-guide",
        "html": "<!doctype html><html><body><h1>Free stretching guide</h1><form data-tentary=\"subscribe\"><input type=\"email\" name=\"email\"><button>Send it to me</button></form><p data-tentary=\"subscribed\">Check your inbox.</p></body></html>",
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/landing-pages');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'title' => 'Free stretching guide',
        'url_slug' => 'stretching-guide',
        'html' => '<!doctype html><html><body><h1>Free stretching guide</h1><form data-tentary="subscribe"><input type="email" name="email"><button>Send it to me</button></form><p data-tentary="subscribed">Check your inbox.</p></body></html>',
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "id": 902,
  "title": "Free stretching guide",
  "type": "html",
  "status": "draft",
  "url_slug": "stretching-guide",
  "url": "https://lena-yoga.mytentary.com/stretching-guide",
  "affiliates": false,
  "created_at": "2026-10-27T08:51:48Z",
  "admin_url": "https://app.tentary.com/landingpages/edit-html/902"
}

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

title string

Name in the Tentary app (not the <title> of the page).

max. Länge 255
url_slug string

The page address: shop URL/<url_slug>. Lowercase letters, digits and hyphens. Default from the title. A url_slug of another landing page gives an error. A new url_slug does not redirect: the old address then opens the shop.

max. Länge 120
html string erforderlich

The full HTML document, served as it is (at most 900 KB). A newsletter sign-up form: put data-tentary="subscribe" on the <form> tag and an <input type="email"> in it, with no JavaScript for the form. Right after the form, outside it, add one element with data-tentary="subscribed" that holds the confirmation text; Tentary shows it after the sign-up (do not hide or show it with your own code). Only for a separate thank-you page, add data-tentary-return="/its-address" on the <form> tag. Link to products with their shop URL from list_products.

max. Länge 900000
status string

live = public at its URL. draft = not public (the URL opens the shop).

Mögliche Werte: draftlive
affiliates boolean

Show the page to the seller's affiliates in their affiliate hub, with their affiliate ID attached.

Antwort

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

id integer

The ID.
title string

Name in the Tentary app.
type string

html = own HTML code. builder = made with the page builder in the app.

Mögliche Werte: htmlbuilder
status string

draft = not public: its URL opens the shop.

Mögliche Werte: livedraft
url_slug string

The address part of the URL.
url string<uri>

shop URL/<url_slug>.
affiliates boolean

true = shown to the affiliates in their affiliate hub.
created_at string<date-time> kann null sein

UTC, like 2026-01-31T14:05:00Z.
admin_url string<uri>

The page in the Tentary app.