Create an invoice

POST https://api.tamio.com/v2/orders/create

Creates a new one-time invoice with customer details, products, and payment configuration. Requires either payment method IDs or custom payment instructions.

Products can reference existing catalog products by id, product variants by variant, or be custom line items with name and price.

Body Parameters

customer object*

date object*

Invoice creation date (ISO format or Unix timestamp)

due_date object

Payment due date (ISO format or Unix timestamp)

label string

Invoice label/title

locale string

Language code for localization

currency string*

Three-letter ISO currency code

taxes string

Tax calculation method

accountoff

prefix string

Invoice number prefix (e.g., 'INV-')

invoice_number integer

Custom invoice number (auto-generated if omitted)

send_to_customer boolean

Send invoice to customer via email after creation

custom_payment string

Custom payment instructions (required when no payment methods)

payments array of string

Payment method IDs enabled for this invoice

fulfillment_options FulfillmentOptions

shipping object

Shipping information and cost

products array of InvoiceProduct*

Products or services to invoice

Responses

200 Invoice created successfully

Invoice created successfully

status integer

transaction object

Transaction object with invoice details

invoice string

UUID of the created invoice

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`10245`	TransactionsQuotaFull

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Retrieve an order

Create a recurring invoice

/orders/create

1 const response = await fetch("https://api.tamio.com/v2/orders/create", {
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/orders/create")
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,
  "transaction": {},
  "invoice": "string"
}

1	const response = await fetch("https://api.tamio.com/v2/orders/create", {
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/orders/create")
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