Set the default template
/templates/{id}/set_defaultCosts 2 rate-limit points · Rate limits
Make a template the default for one or more order kinds: orders, draft_orders, pos_orders or credit_notes (default: orders). The previous default for each kind is cleared. Returns the template in full.
Applies to documents generated from now on, including automatic invoices.
Also searched asset default templateuse this template for all ordersmake it the default for credit notesdefault packing slipchange my default invoice template
Path parameters
idstringRequiredTemplate id.
Request body
forarray of stringsOrder kinds: orders, draft_orders, pos_orders, credit_notes. Defaults to ["orders"].
Returns
The template object.
Errors
Missing or unknown X-Auth-Token, or the shop uninstalled the app.
v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.
The resource does not exist for this shop, or no action is registered at this path.
The request failed validation. Nothing was saved.
Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.
Every error has the same shape: see Errors.
curl -X POST "https://app.invoicefalcon.com/api/v3/external/templates/125/set_default" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/templates/125/set_default", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/templates/125/set_default",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/templates/125/set_default")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)curl -X POST "https://app.invoicefalcon.com/api/v3/external/templates/125/set_default" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"for": [
"orders",
"draft_orders",
"pos_orders"
]
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/templates/125/set_default", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"for": [
"orders",
"draft_orders",
"pos_orders"
]
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/templates/125/set_default",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"for": [
"orders",
"draft_orders",
"pos_orders"
]
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/templates/125/set_default")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
for: [
"orders",
"draft_orders",
"pos_orders"
]
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"id": 138,
"name": "Spare",
"document_type": "invoice",
"design": null,
"default_for": {
"orders": true,
"draft_orders": false,
"pos_orders": false,
"credit_notes": true
},
"logo": {
"enabled": true,
"url": null,
"width": 150,
"lock_aspect_ratio": true
},
"created_at": "2026-11-10T09:07:42Z",
"updated_at": "2026-11-10T09:07:42Z",
"style": {
"accent_color": "#000000",
"font_family": "Arial",
"font_size": 12,
"date_format": "MMM DD, YYYY"
},
"numbering": {
"prefix": "INV",
"next_number": null,
"use_order_number": true,
"credit_notes_use_order_number": false,
"sequential_numbering_available": true
},
"sections": {
"order_information": {
"show_invoice_number": true,
"show_custom_invoice_number": false,
"show_order_number": true,
"show_po_number": false,
"show_delivery_note_number": false,
"show_order_date": true,
"show_issue_date": false,
"show_due_date": false,
"show_fulfillment_date": false,
"show_payment_terms": false,
"show_order_amount": true,
"show_order_tags": false,
"show_barcode": false,
"show_order_barcode": false
},
"payment_information": {
"show_payment_address": true,
"show_payment_method": true,
"show_payment_breakdown": false,
"show_credit_card": true,
"show_financial_status": false,
"show_discount_code": false,
"show_tax_date": false,
"show_tracking_company": false,
"show_tracking_numbers": false,
"show_paid_by_customer": true
},
"shipping_information": {
"show_shipping_address": true
},
"customer_information": {
"show_customer_email": true,
"show_customer_phone": true,
"show_customer_note": true,
"show_localized_tax_id": false,
"localized_tax_id_string": "Tax ID"
},
"items": {
"show_product_images": true,
"show_sku": true,
"show_hs_code": false,
"show_product_weight": false,
"show_total_product_weight": false,
"show_country_of_origin": false,
"show_product_type": false,
"show_product_description": false,
"show_note_attributes": false,
"show_variants": true,
"show_selling_plan": false,
"show_item_discount": false,
"show_discount_reason": false,
"show_compare_at_price": false,
"show_original_price": false,
"show_properties": true,
"show_item_barcode": false,
"show_total_qty": false,
"show_item_tax": true,
"show_item_tax_amount": true,
"group_amount_digits": false
},
"order_total": {
"show_subtotal": true,
"show_order_discount": true,
"show_order_discount_reason": false,
"show_discount_breakdown": false,
"show_tax": true,
"show_tax_inclusion_label": false,
"show_tax_breakdown": true,
"show_shipping": true,
"show_discounts": true,
"show_shipping_rate_name": true,
"show_amount_in_words": false,
"show_total_weight": false,
"show_refund_amount": true,
"show_refund_reason": false,
"show_payment_link": false,
"show_balance": true
},
"extra": {
"show_order_notes": true,
"show_footer_notes": false,
"footer_message": null,
"show_store_domain": false,
"store_domain_text": null,
"show_paid_unpaid_watermark": false
},
"social": {
"show_social_page": false,
"facebook_url": null,
"instagram_url": null,
"twitter_url": null
}
},
"label_overrides": {},
"content_translations": {},
"liquid_code": " <!DOCTYPE html>\n <html>\n <head>\n <meta charset=\"utf-8\">\n <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Open+Sans:wght@400;600;700&family=No…"
}{
"errors": [
"Invalid API key"
],
"code": "unauthorized"
}{
"errors": [
"API access requires a paid plan"
],
"code": "paid_plan_required"
}{
"errors": [
"Resource not found"
],
"code": "not_found"
}{
"errors": [
"id is missing"
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited"
}