# Create Invoice

Creates a new invoice.

Endpoint: POST /billing/invoices
Version: 1.0.0
Security: apiKeyAuth

## Header parameters:

  - `x-entity-id` (string)
    Optional entity ID for scoped access to entity-specific data

## Request fields (application/json):

  - `customer_id` (string, required)

  - `line_items` (array, required)

  - `line_items.product_id` (string, required)

  - `line_items.quantity` (any, required)
    Quantity of the product

  - `line_items.price` (any)

  - `line_items.description` (any)
    Description of the product, will default to the product's description if not provided

  - `line_items.discount_percentage` (any)

  - `line_items.discount_description` (any)
    Description of the discount applied to the product

  - `invoice_date` (string, required)
    Date the invoice is scheduled to be sent

  - `due_date` (string, required)
    Date the invoice is due

  - `payment_method_types` (array, required)
    Payment method types to enable on the invoice. BANK_TRANSFER is always enabled.
    Enum: "BANK_TRANSFER", "CARD", "ACH_DIRECT_DEBIT", "INTERNATIONAL_WIRE", "USDC_ETHEREUM", "USDC_SOLANA", "USDC_BASE", "USDT_ETHEREUM"

  - `recurring_schedule` (any)
    Recurring schedule for the invoice. Enter a valid RFC 2445 RRULE string. If you need help creating one, use https://icalendar.org/rrule-tool.html

  - `send_email_on_creation` (boolean, required)
    If true, sends an email to the contact (and any additional recipients) on the invoice_date.

  - `additional_recipient_emails` (any)
    Additional recipient emails to send the invoice and any reminders to

  - `note` (any)
    Note to include on the invoice

  - `name` (any)
    Name of the invoice

  - `collection_account_id` (string, required)
    Account ID that payments on this invoice will be deposited to

  - `show_contact_address` (boolean)
    Whether to show the contact's address on the invoice, if it exists

## Response 200 fields (application/json):

  - `id` (string, required)

  - `name` (any)

  - `customer_id` (string, required)

  - `line_item_ids` (array, required)

  - `invoice_date` (any, required)

  - `due_date` (any, required)

  - `payment_method_types` (array, required)
    Enum: "BANK_TRANSFER", "CARD", "ACH_DIRECT_DEBIT", "INTERNATIONAL_WIRE", "USDC_ETHEREUM", "USDC_SOLANA", "USDC_BASE", "USDT_ETHEREUM"

  - `send_email_on_creation` (boolean, required)

  - `additional_recipient_emails` (array, required)

  - `note` (any)

  - `collection_account_id` (string, required)

  - `created_at` (string, required)
    ISO 8601 date-time in format 'YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]' according to [IETF RFC3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)

  - `updated_at` (any)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)