Skip to content
TriggerStripeReal-timeUpdated May 2026

How do I trigger when a Stripe invoice is paid?

Short answer: Drop the "StripeInvoice Paid" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Stripe, not on a polling schedule.

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder
Trigger
Invoice Paid
When the matching event happens
on invoice paidnew invoice paidwhen an invoice is paid in stripewatch for invoice paidwhen invoice paid
What this trigger returns
for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
"number": "TC-001",
"status": "paid",
"created": 1778804246,
"currency": "usd",
"customer": "cus_xxx",
"event_id": "evt_xxx",
"livemode": false,
"amount_due": 500,
"event_type": "invoice.paid",
"invoice_id": "in_xxx",
"amount_paid": 500,
"invoice_pdf": "https://pay.stripe.com/xxx.pdf",
"occurred_at": 1778804246,
"subscription": "sub_xxx",
"customer_email": "tc@example.com",
"hosted_invoice_url": "https://invoice.stripe.com/xxx"
}
Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

FieldTypeExample
numberstring"TC-001"
statusstring"paid"
creatednumber1778804246
currencystring"usd"
customerstring"cus_xxx"
event_idstring"evt_xxx"
livemodebooleanfalse
amount_duenumber500
event_typestring"invoice.paid"
invoice_idstring"in_xxx"
amount_paidnumber500
invoice_pdfstring"https://pay.stripe.com/xxx.pdf"
occurred_atnumber1778804246
subscriptionstring"sub_xxx"
customer_emailstring"tc@example.com"
hosted_invoice_urlstring"https://invoice.stripe.com/xxx"
FAQ

Questions about Invoice Paid.

How does the Invoice Paid trigger work in Stripe?
Fires when an invoice is paid in Stripe. Use to recognise revenue in your accounting system, extend the subscription, or thank the customer.
Is the Invoice Paid trigger real-time?
Yes. Invoice Paid uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Stripe.
What data does Invoice Paid return?
The full event payload from Stripe. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.
Can I filter Invoice Paid so only some events start a workflow?
Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.
Do I need Stripe admin permissions to use Invoice Paid?
For most Stripe accounts a standard user can authorize the trigger. Some Stripe plans require an admin to enable third-party webhooks. Check Stripe's docs if the trigger fails to register.
More triggers

Other Stripe triggers.

Build a workflow on this trigger.

One trigger. 31+ downstream actions. Zero glue.