---
title: "invoice.finalized webhook"
method: POST
path: "invoice.finalized"
tags: ["webhooks"]
---

# invoice.finalized webhook

`POST invoice.finalized` (webhook)

An invoice was finalized

## Payload

- InvoiceEvent
  - `created_at` string, date-time, required
  - `currency` string, required
  - `customer_id` string, MeteroidId, required
  - `invoice_id` string, MeteroidId, required
  - `status` 'Draft' | 'Finalized' | 'Uncollectible' | 'Void', required
  - `tax_amount` integer, required
  - `total` integer, required
  - `id` string, MeteroidId, required
  - `timestamp` string, date-time, required
  - `type` 'metric.created' | 'customer.created' | 'subscription.created' | 'invoice.created' | 'invoice.finalized' | 'invoice.paid' | 'invoice.voided' | 'quote.accepted' | 'quote.converted' | 'credit_note.created' | 'credit_note.finalized' | 'credit_note.voided', required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/f9c417ec1ed4/schema)