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

# invoice.finalized webhook

`POST invoice.finalized` (webhook)

An invoice was finalized

## Payload

- WebhookOutEvent
  - `data` union, required
    - WebhookOutCustomerEventData
      - `alias` string, nullable
      - `billing_email` string, nullable
      - `currency` string, required
      - `id` string, MeteroidId, required
      - `invoicing_emails` string[], required
      - `name` string, required
      - `phone` string, nullable
    - WebhookOutInvoiceEventData
      - `created_at` string, date-time, required
      - `currency` string, required
      - `customer_id` string, MeteroidId, required
      - `id` string, MeteroidId, required
      - `status` 'Draft' | 'Finalized' | 'Uncollectible' | 'Void', required
      - `tax_amount` integer, required
      - `total` integer, required
    - WebhookOutSubscriptionEventData
      - `activated_at` string, date-time, nullable
      - `billing_day_anchor` integer, required
      - `billing_start_date` string, date, nullable
      - `created_at` string, date-time, required
      - `currency` string, required
      - `customer_alias` string, nullable
      - `customer_id` string, MeteroidId, required
      - `customer_name` string, required
      - `end_date` string, date, nullable
      - `id` string, MeteroidId, required
      - `invoice_memo` string, nullable
      - `invoice_threshold` string, nullable
      - `mrr_cents` integer, required
      - `net_terms` integer, required
      - `period` 'MONTHLY' | 'QUARTERLY' | 'SEMIANNUAL' | 'ANNUAL', required
      - `plan_name` string, required
      - `start_date` string, date, required
      - `status` 'PENDING_ACTIVATION' | 'PENDING_CHARGE' | 'TRIAL_ACTIVE' | 'ACTIVE' | 'TRIAL_EXPIRED' | 'PAUSED' | 'SUSPENDED' | 'CANCELLED' | 'COMPLETED' | 'SUPERSEDED' | 'ERRORED', required
      - `trial_duration` integer, nullable
      - `version` integer, required
    - WebhookOutMetricEventData
      - `aggregation_key` string, nullable
      - `aggregation_type` 'COUNT' | 'LATEST' | 'MAX' | 'MIN' | 'MEAN' | 'SUM' | 'COUNT_DISTINCT', required
      - `code` string, required
      - `created_at` string, date-time, required
      - `description` string, nullable
      - `id` string, MeteroidId, required
      - `name` string, required
      - `product_family_id` string, MeteroidId, required
      - `product_id` string, MeteroidId
      - `segmentation_matrix` union
        - MetricDimension
          - `key` string, required
          - `values` string[], required
        - object
          - `dimension1` MetricDimension, required
            - `key` string, required
            - `values` string[], required
          - `dimension2` MetricDimension, required
            - `key` string, required
            - `values` string[], required
          - `discriminator` 'DOUBLE', required
        - object
          - `dimension1_key` string, required
          - `dimension2_key` string, required
          - `discriminator` 'LINKED', required
          - `values` object, required
      - `unit_conversion_factor` integer, nullable
      - `unit_conversion_rounding` 'UP' | 'DOWN' | 'NEAREST' | 'NEAREST_HALF' | 'NEAREST_DECILE' | 'NONE'
      - `usage_group_key` string, nullable
    - WebhookOutQuoteEventData
      - `customer_id` string, MeteroidId, required
      - `id` string, MeteroidId, required
      - `subscription_id` string, MeteroidId
    - WebhookOutCreditNoteEventData
      - `created_at` string, date-time, required
      - `credited_amount_cents` integer, required
      - `currency` string, required
      - `customer_id` string, MeteroidId, required
      - `id` string, MeteroidId, required
      - `invoice_id` string, MeteroidId, required
      - `refunded_amount_cents` integer, required
      - `status` 'DRAFT' | 'FINALIZED' | 'VOIDED', 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/7d4a46169b06/schema)