invoice.upcoming

{ "event": "invoice.upcoming", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "status": "active", "planId": "pln_pro_monthly", "planName": "Pro", "billingInterval": "monthly", "currentPeriodEnd": "2026-04-25T00:00:00.000Z" } }

When this fires

A daily scan finds active subscriptions renewing within the next 3 days and emits this event once per renewal. The idempotency key is derived from the subscription and the renewal date, so re-running the scan never sends a duplicate.

Subscriptions with a scheduled cancellation are excluded — no renewal invoice will be issued for them.

Use it to notify the customer before they are charged. The payload intentionally carries no amount: usage-based charges are only final at renewal time, when invoice.created delivers the actual invoice.

Body

application/json

string

required

event

string

required

Allowed value: "invoice.upcoming"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

invoice.upcoming

When this fires

Body

Response

​When this fires

Body

Response

When this fires