Rabattcodes

Create coupon

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

POST / v1 / coupons

Creates a coupon (discount code). It works at once, or from starts_on.

The answer is the coupon, as in GET /v1/coupons, with its state.

Ändert sofort MCP-Werkzeug create_coupon

curl -X POST "https://api.tentary.com/v1/coupons" \
  -H "Authorization: Bearer $TENTARY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "RUNNER15",
  "percent": 15,
  "max_uses": 50,
  "product_ids": [
    102
  ]
}'

const response = await fetch("https://api.tentary.com/v1/coupons", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TENTARY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "code": "RUNNER15",
    "percent": 15,
    "max_uses": 50,
    "product_ids": [
      102
    ]
  }),
});
const data = await response.json();

import os
import requests

response = requests.post(
    "https://api.tentary.com/v1/coupons",
    headers={"Authorization": f"Bearer {os.environ['TENTARY_API_KEY']}"},
    json={
        "code": "RUNNER15",
        "percent": 15,
        "max_uses": 50,
        "product_ids": [
            102,
        ],
    },
)
data = response.json()

<?php
$ch = curl_init('https://api.tentary.com/v1/coupons');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TENTARY_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'code' => 'RUNNER15',
        'percent' => 15,
        'max_uses' => 50,
        'product_ids' => [
            102,
        ],
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

200 · Antwort

{
  "id": 702,
  "code": "RUNNER15",
  "status": "active",
  "state": "valid",
  "percent": 15,
  "amount": null,
  "currency": "EUR",
  "used": 0,
  "max_uses": 50,
  "reserved_in_open_checkouts": 0,
  "starts_on": null,
  "ends_on": null,
  "product_ids": [
    102
  ],
  "products": [
    {
      "id": 102,
      "name": "Morning Yoga in 30 Days",
      "status": "live"
    }
  ],
  "created_at": null,
  "admin_url": "https://app.tentary.com/discounts/edit/702"
}

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

code string erforderlich

The code buyers type, like SUMMER20. Unique in the shop (upper and lower case count as the same).

min. Länge 1 max. Länge 255
percent integer

Discount in percent. Give percent or amount.

min. 1 max. 100
amount number | string

Fixed discount. Amount in the account currency, like 49 or 19.99.

größer als 0 Muster ^[0-9]{1,9}(\.[0-9]{1,2})?$
max_uses integer

How often the code can be used in total. 0 = no limit. On create, left out = no limit. On update, left out = no change, null removes the limit.

min. 0
starts_on string

First day the code works, like 2026-11-27. On create, left out = at once. On update, left out = no change, null removes the date.

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

The code stops at the start of this day (00:00). On create, left out = no end. On update, left out = no change, null removes the date.

Muster ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
product_ids array of integer kann null sein

Only these products (ids from list_products). null = all products. On create, left out = all products. On update, left out = no change. [] = no product (the code works nowhere).

max. Einträge 200

Antwort

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

id integer

The ID.
code string

The code buyers type.
status string

What the seller set. archived = deleted.

Mögliche Werte: activearchived
state string

The result for buyers: valid = buyers can use the code now.

Mögliche Werte: validscheduledexpiredused_upreservedarchivedno_products
percent integer kann null sein

Discount in percent, or null for a fixed amount.
amount string kann null sein

Decimal string, like "19.90". Fixed discount, or null for a percent discount.
currency string

Currency code, like EUR.
used integer

How often the code was used.
max_uses integer kann null sein

null = no limit.
reserved_in_open_checkouts integer

Uses held by open checkouts of the last hour.
starts_on string<date> kann null sein

Like 2026-01-31. First day the code works.
ends_on string<date> kann null sein

Like 2026-01-31. The code stops at the start of this day.
product_ids array of integer kann null sein

null = all products. [] = no product.
products array of object

The products of product_ids (the first 200).
3 Felder anzeigen Felder ausblenden
- id integer
  
  The ID.
- name string kann null sein
  
  The name.
- status string
  
  The status.
  
  Mögliche Werte: livedraftarchiveddeleted
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.