v1

latestOpenAPI 3.1.0AGPL-3.0-only2026-07-1773264353.7 KB
webhooks

invoice.created webhook

A new invoice was created

postWebhookinvoice.created

Payload

consolidated_into_invoice_idstring MeteroidId
created_atstring date-time required
currencystring required
customer_idstring MeteroidId required
invoice_idstring MeteroidId required
status'DRAFT' | 'FINALIZED' | 'UNCOLLECTIBLE' | 'VOID' required
tax_amountinteger required
totalinteger required
idstring MeteroidId required
timestampstring date-time required
type'metric.created' | 'customer.created' | 'subscription.created' | 'invoice.created' | 'invoice.finalized' | 'invoice.paid' | 'invoice.voided' | 'invoice.consolidated' | 'quote.accepted' | 'quote.converted' | 'credit_note.created' | 'credit_note.finalized' | 'credit_note.voided' | 'plan.created' | 'plan.published' | 'plan.archived' | 'product.created' | 'product.updated' | 'product.archived' | 'metric.updated' | 'metric.archived' | 'coupon.created' | 'coupon.updated' | 'coupon.archived' | 'addon.created' | 'addon.updated' | 'addon.archived' required

Example payload

{
  "consolidated_into_invoice_id": "inv_7n42DGM5Tflk9n8mt7Fhc7",
  "customer_id": "cus_7n42DGM5Tflk9n8mt7Fhc7",
  "invoice_id": "inv_7n42DGM5Tflk9n8mt7Fhc7",
  "id": "evt_7n42DGM5Tflk9n8mt7Fhc7"
}

Response

Webhook received successfully