Skip to main content
POST
Create invoice line item

Authorizations

Authorization
string
header
required

API key authentication via Bearer token

Headers

idempotency-key
string

Key that makes this request safe to retry. Reuse the same value when retrying a request that may already have succeeded — the original response is replayed with an Idempotency-Replay: true header. Use a new value for a new operation.

Required string length: 1 - 255
Example:

"9f8c2b1a-4d3e-4a6b-8c1d-2e3f4a5b6c7d"

Path Parameters

id
string<uuid>
required

Invoice UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
description
string
required
Minimum string length: 1
quantity
string
required
Pattern: ^-?(?!0{1,9}(?:\.0{1,4})?$)\d{1,9}(?:\.\d{1,4})?$
unitAmountCents
integer
required
Required range: -2147483648 <= x <= 2147483647
position
integer

Zero-based display position. A position after the current end appends the line item.

Required range: 0 <= x <= 2147483647

Response

Invoice line item created successfully

data
object
required
meta
object
Last modified on August 30, 2026