Create a discount code

curl --request POST \
  --url https://api.agentaos.ai/api/v1/gateway/discount-codes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "code": "LAUNCH20",
  "name": "Launch week",
  "percentOff": 20
}
'

import requests

url = "https://api.agentaos.ai/api/v1/gateway/discount-codes"

payload = {
    "code": "LAUNCH20",
    "name": "Launch week",
    "percentOff": 20
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({code: 'LAUNCH20', name: 'Launch week', percentOff: 20})
};

fetch('https://api.agentaos.ai/api/v1/gateway/discount-codes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agentaos.ai/api/v1/gateway/discount-codes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'code' => 'LAUNCH20',
    'name' => 'Launch week',
    'percentOff' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agentaos.ai/api/v1/gateway/discount-codes"

	payload := strings.NewReader("{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.agentaos.ai/api/v1/gateway/discount-codes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentaos.ai/api/v1/gateway/discount-codes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "code": "<string>",
  "kind": "discount",
  "archivedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "active": true,
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "productNames": [
    "<string>"
  ]
}

{
  "statusCode": 400,
  "message": "amount is required when creating a session without a link",
  "timestamp": "2026-08-06T12:00:00.000Z"
}

{
  "statusCode": 401,
  "message": "Invalid API key",
  "timestamp": "2026-08-06T12:00:00.000Z"
}

{
  "statusCode": 403,
  "message": "This needs a signed-in owner or admin, not an API key.",
  "timestamp": "2026-10-31T12:00:00.000Z"
}

{
  "statusCode": 429,
  "message": "Too many tries in a row. Wait a minute, then try again.",
  "timestamp": "2026-10-31T12:00:00.000Z"
}

POST

gateway

discount-codes

Create a discount code

curl --request POST \
  --url https://api.agentaos.ai/api/v1/gateway/discount-codes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "code": "LAUNCH20",
  "name": "Launch week",
  "percentOff": 20
}
'

import requests

url = "https://api.agentaos.ai/api/v1/gateway/discount-codes"

payload = {
    "code": "LAUNCH20",
    "name": "Launch week",
    "percentOff": 20
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({code: 'LAUNCH20', name: 'Launch week', percentOff: 20})
};

fetch('https://api.agentaos.ai/api/v1/gateway/discount-codes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agentaos.ai/api/v1/gateway/discount-codes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'code' => 'LAUNCH20',
    'name' => 'Launch week',
    'percentOff' => 20
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agentaos.ai/api/v1/gateway/discount-codes"

	payload := strings.NewReader("{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.agentaos.ai/api/v1/gateway/discount-codes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentaos.ai/api/v1/gateway/discount-codes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"code\": \"LAUNCH20\",\n  \"name\": \"Launch week\",\n  \"percentOff\": 20\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "code": "<string>",
  "kind": "discount",
  "archivedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "active": true,
  "productIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "productNames": [
    "<string>"
  ]
}

{
  "statusCode": 400,
  "message": "amount is required when creating a session without a link",
  "timestamp": "2026-08-06T12:00:00.000Z"
}

{
  "statusCode": 401,
  "message": "Invalid API key",
  "timestamp": "2026-08-06T12:00:00.000Z"
}

{
  "statusCode": 403,
  "message": "This needs a signed-in owner or admin, not an API key.",
  "timestamp": "2026-10-31T12:00:00.000Z"
}

{
  "statusCode": 429,
  "message": "Too many tries in a row. Wait a minute, then try again.",
  "timestamp": "2026-10-31T12:00:00.000Z"
}

Needs a signed-in owner or admin. An API key is refused with 403: create and stop codes in the dashboard, under Discounts.

Webhook: none. A discount code moves no money until a buyer uses it at checkout. See Which action fires which event.

Authorizations

x-api-key

string

header

required

Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.

Body

application/json

code

string

required

What the buyer types. Letters, numbers, dashes and underscores.

Pattern: ^[A-Za-z0-9_-]{1,64}$

name

string

Your own label for the code, shown back to you on the single-code route. Not allowed on a code that carries no discount.

Maximum string length: 120

percentOff

number

Percentage off the first invoice. A code cannot take the whole price off — set up a free trial for that.

Required range: 0.01 <= x <= 99

amountOffMinor

integer

Integer minor units. The currency is the one the products in productIds share (they must all use one), or your settlement currency when the code works on every product. It comes off the total the buyer pays, VAT included.

Required range: x >= 1

maxRedemptions

integer

Required range: x >= 1

expiresAt

string<date-time>

Must be in the future.

productIds

string<uuid>[]

Limit the code to these products, one-time or subscription, in any mix. Leave it out for every product you own.

Maximum array length: 100

Response

Discount code created.

Fully camelCase on the wire.

string<uuid>

required

code

string

required

As you typed it. Buyers may type it in any case.

kind

enum<string>

required

discount changes the price. tracking changes nothing and only records who used it.

Available options:

discount,

tracking

archivedAt

string<date-time> | null

required

createdAt

string<date-time>

required

active

boolean

required

Usable as far as this list can tell: not archived, and fully created. Whether the code has since been used up is answered by the single-code route.

productIds

string<uuid>[]

required

The products this code works on, one-time or subscription. Empty means every product you own.

productNames

string[]

required

The names of those products, in the same order.

SDK

CLI

API Reference

Create a discount code

Authorizations

Body

Response