---
title: "Create Invoice"
method: POST
path: "/integration/invoices"
tags: ["integration"]
---

# Create Invoice

`POST /integration/invoices`

## Request

- Base URL: `https://app.orla.finance/api`
- URL: `https://app.orla.finance/api/integration/invoices`
- Auth: HTTP bearer

## Request body

- IntegrationInvoiceCreate
  - `account_id` string, uuid, required
  - `client_address` string
  - `client_country` string
  - `client_country_code` string
  - `client_email` union
    - string, email
    - ''
  - `client_name` string, required
  - `client_phone` string
  - `client_reg_number` string
  - `client_tax_id` string
  - `contact_id` string, uuid, nullable
  - `contract_id` string, uuid, nullable
  - `currency` string, nullable
  - `due_on` string, date, required
  - `early_discount_pct` union
    - number
    - string
  - `early_discount_until` string, date, nullable
  - `extra_account_ids` string[], nullable
  - `issued_on` string, date, nullable
  - `line_items` LineItem[], required
    - `description` string, required
    - `quantity` string
    - `tax_kind` 'standard' | 'zero' | 'exempt' | 'reverse_charge': What a line item is, for tax purposes.
    - `tax_rate` string
    - `unit` string
    - `unit_price` string, required
  - `notes` string
  - `number` string, nullable
  - `prices_include_tax` boolean, nullable
  - `project_id` string, uuid, nullable
  - `purchase_order` string
  - `save_contact` boolean
  - `seller` SellerOverride: Issuer requisites for one mirrored invoice, when the integration issues on behalf of more than one legal entity (the space profile fits only one).
    - `address` string
    - `country` string
    - `email` string
    - `logo` string
    - `name` string, required
    - `phone` string
    - `reg_number` string
    - `tax_id` string
    - `website` string
  - `tax_authority_number` string
  - `tax_exempt_reason` string, nullable
  - `tax_zero_reason` string, nullable

## Response `201`

Successful Response

- InvoiceOut
  - `account_id` string, uuid, nullable
  - `auto_remind` boolean
  - `card_payments_enabled` boolean
  - `card_payments_live` boolean
  - `client_address` string
  - `client_country` string
  - `client_country_code` string
  - `client_email` string, required
  - `client_name` string, required
  - `client_phone` string
  - `client_reg_number` string
  - `client_tax_id` string
  - `contact_id` string, uuid, nullable
  - `contested_at` string, date-time, nullable
  - `contested_reason` string
  - `corrects_invoice_id` string, uuid, nullable
  - `credited_amount` string
  - `currency` string, required
  - `delivered_in_app` boolean
  - `due_on` string, date, required
  - `early_discount_amount` string, nullable
  - `early_discount_note_id` string, uuid, nullable
  - `early_discount_pct` string, nullable
  - `early_discount_until` string, date, nullable
  - `extra_account_ids` string[]
  - `id` string, uuid, required
  - `issued_on` string, date, required
  - `kind` 'invoice' | 'credit_note' | 'quote': A document that asks for money, or one that gives it back.
  - `last_paid_on` string, date, nullable
  - `line_items` unknown[], required
    - unknown
  - `line_step` string
  - `notes` string, required
  - `number` string, required
  - `number_pending` boolean
  - `origin` string
  - `paid_amount` string
  - `payer_marked_paid_at` string, date-time, nullable
  - `payment_withdrawn_at` string, date-time, nullable
  - `prices_include_tax` boolean
  - `project_id` string, uuid, nullable
  - `promised_on` string, date, nullable
  - `purchase_order` string
  - `reminders_paused_at` string, date-time, nullable
  - `seller_address` string
  - `seller_country` string
  - `seller_email` string
  - `seller_name` string
  - `seller_phone` string
  - `seller_reg_number` string
  - `seller_tax_id` string
  - `seller_website` string
  - `status` 'draft' | 'sent' | 'partial' | 'paid' | 'issued' | 'void' | 'quote_draft' | 'quote_sent' | 'quote_accepted' | 'quote_declined' | 'quote_expired' | 'quote_withdrawn', required
  - `subtotal` string
  - `tax_authority_number` string
  - `tax_breakdown` unknown[]
    - unknown
  - `tax_label` string
  - `tax_total` string
  - `token` string, required
  - `total` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors.md) · [All operations](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/llms.txt) · [OpenAPI document](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/revisions/5c8a8112ea7c?raw)