Create an add-on

POST https://api.tamio.com/v2/subscriptions/addons/create/{uuid}

Attaches a new add-on to a subscription with flexible billing (one-time, limited payments, or recurring) and optional tax configuration.

Path Parameters

uuid string*

UUID of the subscription.

Body Parameters

description string*

Add-on name/description.

cost integer*

Price in smallest currency unit.

duration string*

once — one-time charge; limited — specific number of payments (requires number_of_payments); recurring — ongoing with the subscription.

oncelimitedrecurring

number_of_payments integer

Total payments (required when duration is limited).

vat_classification string

VAT classification for tax calculation.

digitalphysicalnotax

tax_calculation string

exclusive — tax added to price; inclusive — tax included.

exclusiveinclusive

tax_rate object

Custom tax rate (alternative to VAT classification).

Responses

200 Add-on created

Add-on created

status integer

subscription Subscription

upcoming_invoice object

Updated upcoming invoice preview.

addon Addon

400 Validation or business-logic error

401 Missing or invalid API key

List subscription add-ons

Remove an add-on

/subscriptions/addons/create/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/subscriptions/addons/create/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/subscriptions/addons/create/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "subscription": {
    "id": "string",
    "object": "subscription",
    "next_billing_date": 0,
    "cancellation_date": 0,
    "completion_date": 0,
    "resumes_at": 0,
    "products": [],
    "payment_count": 0,
    "status": "string",
    "has_discount": false,
    "gateway_subscription_id": "string",
    "type": "subscription",
    "gateway": "string",
    "billing_cycle": "string",
    "interval": 0,
    "currency": "string",
    "invoice_id": "string",
    "price": 0,
    "lifetime_revenue": 0,
    "management_link": "string",
    "instalments_count": 0,
    "customer": {
      "id": "string",
      "name": "string",
      "first_name": "string",
      "last_name": "string",
      "email": "string",
      "locale": "string",
      "client_id": "string",
      "address_id": "string"
    },
    "imported": false,
    "has_notes": false
  },
  "upcoming_invoice": {},
  "addon": {
    "id": "string",
    "object": "addon",
    "description": "string",
    "amount": 0,
    "currency": "string",
    "duration": "once",
    "type": "string",
    "subscription_id": "string",
    "payment_count": 0,
    "number_of_payments": 0
  }
}

1	const response = await fetch("https://api.tamio.com/v2/subscriptions/addons/create/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/subscriptions/addons/create/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body