Create invoice
post
/api/v1/invoices
Security
Parameters
| Name | In | Type | Details | |
|---|---|---|---|---|
Idempotency-Key |
header |
string
|
optional | Unique key for safe create retries (Make/Zapier/n8n). Replays the stored successful response for the same key + request body within 7 days. |
Request body required
application/json
Example
{
"subject": "Solar Rechnung",
"status": "draft",
"invoice_date": "2026-07-17",
"due_date": "2026-08-17",
"total_amount": 2379.88,
"sale": {
"currency": "EUR",
"to_first_name": "Max",
"to_last_name": "Mustermann",
"to_email": "max@example.com",
"sale_items": [
{
"product_title": "Solar Panel",
"quantity": 10,
"unit_price": 199.99,
"tax_percentage": 19
}
]
}
}
Schema
{
"type": "object",
"properties": {
"subject": {
"type": "string"
},
"status": {
"type": "string"
},
"invoice_date": {
"type": "string",
"format": "date"
},
"due_date": {
"type": "string",
"format": "date"
},
"total_amount": {
"type": "number"
},
"paid_amount": {
"type": "number"
},
"sales_contract_id": {
"type": "integer"
},
"header_notes": {
"type": "string"
},
"sale": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"example": "EUR"
},
"to_type": {
"type": "string",
"example": "person"
},
"to_first_name": {
"type": "string"
},
"to_last_name": {
"type": "string"
},
"to_email": {
"type": "string",
"format": "email"
},
"to_city": {
"type": "string"
},
"to_countries_id": {
"type": "integer"
},
"sale_items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_title": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"tax_percentage": {
"type": "number"
},
"discount_percentage": {
"type": "number"
},
"is_optional": {
"type": "boolean"
},
"show_price": {
"type": "boolean"
}
}
}
}
}
}
}
}
Responses
201
Invoice created
application/json
{
"allOf": [
{
"title": "API envelope",
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string",
"nullable": true
},
"errors": {
"nullable": true
},
"meta": {
"type": "object",
"nullable": true,
"additionalProperties": true
}
}
},
{
"type": "object",
"properties": {
"data": {
"title": "Invoice",
"type": "object",
"required": [
"id",
"is_credit_note"
],
"properties": {
"id": {
"type": "integer"
},
"sales_id": {
"type": "integer",
"nullable": true
},
"sales_contract_id": {
"type": "integer",
"nullable": true
},
"status": {
"type": "string",
"nullable": true
},
"invoice_number": {
"type": "string",
"nullable": true
},
"final_invoice_number": {
"type": "string",
"nullable": true
},
"invoice_date": {
"type": "string",
"nullable": true
},
"due_date": {
"type": "string",
"nullable": true
},
"payment_target": {
"type": "string",
"nullable": true
},
"payment_target_interval": {
"type": "string",
"nullable": true
},
"payment_target_count": {
"type": "integer",
"nullable": true
},
"subject": {
"type": "string",
"nullable": true
},
"header_notes": {
"type": "string",
"nullable": true
},
"footer_notes": {
"type": "string",
"nullable": true
},
"total_amount": {
"type": "number",
"nullable": true
},
"paid_amount": {
"type": "number",
"nullable": true
},
"payment_percent": {
"type": "number",
"nullable": true
},
"payment_stage": {
"type": "string",
"nullable": true
},
"sent_at": {
"type": "string",
"nullable": true
},
"performance_date_start": {
"type": "string",
"nullable": true
},
"performance_date_end": {
"type": "string",
"nullable": true
},
"performance_date_type": {
"type": "string",
"nullable": true
},
"is_credit_note": {
"type": "boolean"
},
"original_invoice_id": {
"type": "integer",
"nullable": true
},
"credit_note_id": {
"type": "integer",
"nullable": true
},
"credit_reason": {
"type": "string",
"nullable": true
},
"created_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"updated_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"sale": {
"oneOf": [
{
"title": "Sale",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"unique_order_id": {
"type": "string",
"nullable": true
},
"currency": {
"type": "string",
"nullable": true
},
"to_type": {
"type": "string",
"nullable": true
},
"to_first_name": {
"type": "string",
"nullable": true
},
"to_last_name": {
"type": "string",
"nullable": true
},
"to_email": {
"type": "string",
"format": "email",
"nullable": true
},
"to_company_name": {
"type": "string",
"nullable": true
},
"to_address": {
"type": "string",
"nullable": true
},
"to_city": {
"type": "string",
"nullable": true
},
"to_zipcode": {
"type": "string",
"nullable": true
},
"to_countries_id": {
"type": "integer",
"nullable": true
},
"to_contact_id": {
"type": "integer",
"nullable": true
},
"to_organization_id": {
"type": "integer",
"nullable": true
},
"from_first_name": {
"type": "string",
"nullable": true
},
"from_last_name": {
"type": "string",
"nullable": true
},
"from_email": {
"type": "string",
"format": "email",
"nullable": true
},
"from_company_name": {
"type": "string",
"nullable": true
},
"from_address": {
"type": "string",
"nullable": true
},
"from_city": {
"type": "string",
"nullable": true
},
"from_zipcode": {
"type": "string",
"nullable": true
},
"from_countries_id": {
"type": "integer",
"nullable": true
},
"deals_unique_id": {
"type": "integer",
"nullable": true
},
"created_at": {
"type": "string",
"format": "date-time",
"nullable": true
},
"sale_items": {
"type": "array",
"items": {
"title": "Sale item",
"type": "object",
"required": [
"id",
"is_optional",
"show_price"
],
"properties": {
"id": {
"type": "integer"
},
"product_id": {
"type": "integer",
"nullable": true
},
"product_title": {
"type": "string",
"nullable": true
},
"product_description": {
"type": "string",
"nullable": true
},
"quantity": {
"type": "number",
"nullable": true
},
"unit_price": {
"type": "number",
"nullable": true
},
"tax_percentage": {
"type": "number",
"nullable": true
},
"discount_percentage": {
"type": "number",
"nullable": true
},
"unit_id": {
"type": "integer",
"nullable": true
},
"unit_name": {
"type": "string",
"nullable": true
},
"display_order": {
"type": "integer",
"nullable": true
},
"is_optional": {
"type": "boolean"
},
"show_price": {
"type": "boolean"
}
}
}
}
}
},
{
"type": "null"
}
]
}
}
}
}
}
]
}
401
Missing or invalid API key
application/json
{
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": false
},
"message": {
"type": "string",
"example": "Missing API key (X-Api-Key)"
}
}
}
422
Validation failed
application/json
{
"title": "API envelope",
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string",
"nullable": true
},
"errors": {
"nullable": true
},
"meta": {
"type": "object",
"nullable": true,
"additionalProperties": true
}
}
}