billing.invoice_created

project_id is always null for billing events — these describe the creator's relationship with Subscriby itself, not their subscribers.

When this fires

A new invoice is generated for the creator's Subscriby tier subscription.

Required ability

billing:read — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "billing.invoice_created",
  "created_at": "2026-05-18T10:05:00Z",
  "api_version": "2026-05-01",
  "project_id": null,
  "data": {
    "creator_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "invoice_id": "in_1Nxy..",
    "amount": "49.00",
    "currency": "USD",
    "hosted_invoice_url": "https://invoice.stripe.com/..",
    "attempt_count": 0
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `billing.invoice_created` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	null	Always `null` — account-level event.
`data.creator_id`	string UUID	Creator the invoice is addressed to. The only `data` key guaranteed present.
`data.invoice_id`	string, nullable	Provider invoice id. `null` if the provider payload carried no invoice id.
`data.amount`	string, nullable	Invoice amount in major units of `currency`, formatted as a string. `null` if no amount was due.
`data.currency`	string, nullable	ISO 4217 currency code. `null` if the provider payload carried no currency.
`data.hosted_invoice_url`	string, nullable	URL to the provider-hosted invoice page. `null` on a draft invoice — Stripe issues it at finalization.
`data.attempt_count`	integer, nullable	Number of payment attempts so far. `0` at creation, `null` if the provider payload omitted it.

Caveats

This event is creator-side only. Subscriber invoices, if any, are not represented in billing.*.
Pairs with billing.invoice_paid on success and billing.payment_failed when the first attempt fails.

billing.invoice_paid — successful collection.
billing.payment_failed — failed collection attempt.
Billing events overview — back to family overview.