## Create

`invoices.create(InvoiceCreateParams**kwargs)  -> InvoiceCreateResponse`

**post** `/invoices`

Creates a new invoice

### Parameters

- `invoice_id: str`

  Unique identifier for the invoice. Make this the canonical ID from your system for the transaction.

- `line_items: Iterable[LineItem]`

  List of line items to create with the invoice

  - `amount: str`

    Amount in smallest currency unit (e.g., cents)

  - `currency_code: Literal["ADA", "BTC", "DAI", 176 more]`

    Currency code (ISO 4217 or crypto)

    - `"ADA"`

    - `"BTC"`

    - `"DAI"`

    - `"ETH"`

    - `"SOL"`

    - `"USDC"`

    - `"USDT"`

    - `"USDG"`

    - `"EURC"`

    - `"CADC"`

    - `"CADT"`

    - `"XLM"`

    - `"UNI"`

    - `"BCH"`

    - `"LTC"`

    - `"AAVE"`

    - `"LINK"`

    - `"MATIC"`

    - `"PTS"`

    - `"AED"`

    - `"AFN"`

    - `"ALL"`

    - `"AMD"`

    - `"ANG"`

    - `"AOA"`

    - `"ARS"`

    - `"AUD"`

    - `"AWG"`

    - `"AZN"`

    - `"BAM"`

    - `"BBD"`

    - `"BDT"`

    - `"BGN"`

    - `"BHD"`

    - `"BIF"`

    - `"BMD"`

    - `"BND"`

    - `"BOB"`

    - `"BRL"`

    - `"BSD"`

    - `"BTN"`

    - `"BWP"`

    - `"BYR"`

    - `"BZD"`

    - `"CAD"`

    - `"CDF"`

    - `"CHF"`

    - `"CLP"`

    - `"CNY"`

    - `"COP"`

    - `"CRC"`

    - `"CUC"`

    - `"CUP"`

    - `"CVE"`

    - `"CZK"`

    - `"DJF"`

    - `"DKK"`

    - `"DOP"`

    - `"DZD"`

    - `"EGP"`

    - `"ERN"`

    - `"ETB"`

    - `"EUR"`

    - `"FJD"`

    - `"FKP"`

    - `"GBP"`

    - `"GEL"`

    - `"GGP"`

    - `"GHS"`

    - `"GIP"`

    - `"GMD"`

    - `"GNF"`

    - `"GTQ"`

    - `"GYD"`

    - `"HKD"`

    - `"HNL"`

    - `"HRK"`

    - `"HTG"`

    - `"HUF"`

    - `"IDR"`

    - `"ILS"`

    - `"IMP"`

    - `"INR"`

    - `"IQD"`

    - `"IRR"`

    - `"ISK"`

    - `"JMD"`

    - `"JOD"`

    - `"JPY"`

    - `"KES"`

    - `"KGS"`

    - `"KHR"`

    - `"KMF"`

    - `"KPW"`

    - `"KRW"`

    - `"KWD"`

    - `"KYD"`

    - `"KZT"`

    - `"LAK"`

    - `"LBP"`

    - `"LKR"`

    - `"LRD"`

    - `"LSL"`

    - `"LYD"`

    - `"MAD"`

    - `"MDL"`

    - `"MGA"`

    - `"MKD"`

    - `"MMK"`

    - `"MNT"`

    - `"MOP"`

    - `"MUR"`

    - `"MVR"`

    - `"MWK"`

    - `"MXN"`

    - `"MYR"`

    - `"MZN"`

    - `"NAD"`

    - `"NGN"`

    - `"NIO"`

    - `"NOK"`

    - `"NPR"`

    - `"NZD"`

    - `"OMR"`

    - `"PAB"`

    - `"PEN"`

    - `"PGK"`

    - `"PHP"`

    - `"PKR"`

    - `"PLN"`

    - `"PYG"`

    - `"QAR"`

    - `"RON"`

    - `"RSD"`

    - `"RUB"`

    - `"RWF"`

    - `"SAR"`

    - `"SBD"`

    - `"SCR"`

    - `"SDG"`

    - `"SEK"`

    - `"SGD"`

    - `"SHP"`

    - `"SLL"`

    - `"SOS"`

    - `"SPL"`

    - `"SRD"`

    - `"SVC"`

    - `"SYP"`

    - `"STN"`

    - `"SZL"`

    - `"THB"`

    - `"TJS"`

    - `"TMT"`

    - `"TND"`

    - `"TOP"`

    - `"TRY"`

    - `"TTD"`

    - `"TVD"`

    - `"TWD"`

    - `"TZS"`

    - `"UAH"`

    - `"UGX"`

    - `"USD"`

    - `"UYU"`

    - `"UZS"`

    - `"VEF"`

    - `"VND"`

    - `"VUV"`

    - `"WST"`

    - `"XAF"`

    - `"XCD"`

    - `"XOF"`

    - `"XPF"`

    - `"YER"`

    - `"ZAR"`

    - `"ZMW"`

    - `"LOGICAL"`

    - `"CUSTOM"`

  - `description: str`

    Description of the line item

  - `product_id: str`

    ID of the product/catalog item

  - `type: Literal["payin", "payout"]`

    The type of the line item

    - `"payin"`

    - `"payout"`

  - `user_id: str`

    External ID of the user associated with this line item

### Returns

- `class InvoiceCreateResponse: …`

  - `data: Data`

    Invoice object

    - `id: str`

      Unique identifier for the invoice

    - `created: datetime`

      ISO 8601 timestamp when the invoice was created

    - `status: Literal["active"]`

      The status of the invoice

      - `"active"`

    - `version: float`

      The current version of the invoice. Pass this value when updating to ensure thread safety.

    - `workspace_id: str`

      Workspace ID this invoice belongs to

    - `line_items: Optional[List[DataLineItem]]`

      List of line items associated with this invoice

      - `id: str`

        Unique identifier for the line item

      - `amount: str`

        Amount in smallest currency unit (represented as string for bigint)

      - `currency_code: Literal["ADA", "BTC", "DAI", 176 more]`

        Currency code (ISO 4217 or crypto)

        - `"ADA"`

        - `"BTC"`

        - `"DAI"`

        - `"ETH"`

        - `"SOL"`

        - `"USDC"`

        - `"USDT"`

        - `"USDG"`

        - `"EURC"`

        - `"CADC"`

        - `"CADT"`

        - `"XLM"`

        - `"UNI"`

        - `"BCH"`

        - `"LTC"`

        - `"AAVE"`

        - `"LINK"`

        - `"MATIC"`

        - `"PTS"`

        - `"AED"`

        - `"AFN"`

        - `"ALL"`

        - `"AMD"`

        - `"ANG"`

        - `"AOA"`

        - `"ARS"`

        - `"AUD"`

        - `"AWG"`

        - `"AZN"`

        - `"BAM"`

        - `"BBD"`

        - `"BDT"`

        - `"BGN"`

        - `"BHD"`

        - `"BIF"`

        - `"BMD"`

        - `"BND"`

        - `"BOB"`

        - `"BRL"`

        - `"BSD"`

        - `"BTN"`

        - `"BWP"`

        - `"BYR"`

        - `"BZD"`

        - `"CAD"`

        - `"CDF"`

        - `"CHF"`

        - `"CLP"`

        - `"CNY"`

        - `"COP"`

        - `"CRC"`

        - `"CUC"`

        - `"CUP"`

        - `"CVE"`

        - `"CZK"`

        - `"DJF"`

        - `"DKK"`

        - `"DOP"`

        - `"DZD"`

        - `"EGP"`

        - `"ERN"`

        - `"ETB"`

        - `"EUR"`

        - `"FJD"`

        - `"FKP"`

        - `"GBP"`

        - `"GEL"`

        - `"GGP"`

        - `"GHS"`

        - `"GIP"`

        - `"GMD"`

        - `"GNF"`

        - `"GTQ"`

        - `"GYD"`

        - `"HKD"`

        - `"HNL"`

        - `"HRK"`

        - `"HTG"`

        - `"HUF"`

        - `"IDR"`

        - `"ILS"`

        - `"IMP"`

        - `"INR"`

        - `"IQD"`

        - `"IRR"`

        - `"ISK"`

        - `"JMD"`

        - `"JOD"`

        - `"JPY"`

        - `"KES"`

        - `"KGS"`

        - `"KHR"`

        - `"KMF"`

        - `"KPW"`

        - `"KRW"`

        - `"KWD"`

        - `"KYD"`

        - `"KZT"`

        - `"LAK"`

        - `"LBP"`

        - `"LKR"`

        - `"LRD"`

        - `"LSL"`

        - `"LYD"`

        - `"MAD"`

        - `"MDL"`

        - `"MGA"`

        - `"MKD"`

        - `"MMK"`

        - `"MNT"`

        - `"MOP"`

        - `"MUR"`

        - `"MVR"`

        - `"MWK"`

        - `"MXN"`

        - `"MYR"`

        - `"MZN"`

        - `"NAD"`

        - `"NGN"`

        - `"NIO"`

        - `"NOK"`

        - `"NPR"`

        - `"NZD"`

        - `"OMR"`

        - `"PAB"`

        - `"PEN"`

        - `"PGK"`

        - `"PHP"`

        - `"PKR"`

        - `"PLN"`

        - `"PYG"`

        - `"QAR"`

        - `"RON"`

        - `"RSD"`

        - `"RUB"`

        - `"RWF"`

        - `"SAR"`

        - `"SBD"`

        - `"SCR"`

        - `"SDG"`

        - `"SEK"`

        - `"SGD"`

        - `"SHP"`

        - `"SLL"`

        - `"SOS"`

        - `"SPL"`

        - `"SRD"`

        - `"SVC"`

        - `"SYP"`

        - `"STN"`

        - `"SZL"`

        - `"THB"`

        - `"TJS"`

        - `"TMT"`

        - `"TND"`

        - `"TOP"`

        - `"TRY"`

        - `"TTD"`

        - `"TVD"`

        - `"TWD"`

        - `"TZS"`

        - `"UAH"`

        - `"UGX"`

        - `"USD"`

        - `"UYU"`

        - `"UZS"`

        - `"VEF"`

        - `"VND"`

        - `"VUV"`

        - `"WST"`

        - `"XAF"`

        - `"XCD"`

        - `"XOF"`

        - `"XPF"`

        - `"YER"`

        - `"ZAR"`

        - `"ZMW"`

        - `"LOGICAL"`

        - `"CUSTOM"`

      - `description: str`

        Description of the line item

      - `product_id: str`

        ID of the product/catalog item

      - `type: Literal["payin", "payout"]`

        The type of the line item

        - `"payin"`

        - `"payout"`

      - `user_id: str`

        External ID of the user associated with this line item

    - `modified: Optional[datetime]`

      ISO 8601 timestamp when the invoice was last modified

### Example

```python
from fragment import Fragment

client = Fragment()
invoice = client.invoices.create(
    invoice_id="invoice_2024_001",
    line_items=[{
        "amount": "1000",
        "currency_code": "USD",
        "description": "Professional services for January 2026",
        "product_id": "prod_1234567890",
        "type": "payout",
        "user_id": "user_ext_456",
    }],
)
print(invoice.data)
```