Landing pages

Create landing page

View as Markdown Raw markdown in a new tab Open in ChatGPT Ask questions about this page Open in Claude Ask questions about this page

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.

Changes at once MCP tool 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 · Response

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

Authorization

Authorization string header required

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

Body application/json

title string

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

max length 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 length 120
html string required

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 length 900000
status string

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

Allowed values: draftlive
affiliates boolean

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

Response

Fields of the answer with status 200. Errors always have the same format, see Errors.

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.

Allowed values: htmlbuilder
status string

draft = not public: its URL opens the shop.

Allowed values: 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> can be null

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

The page in the Tentary app.