TriggerChargebeeReal-timeUpdated May 2026
When does Chargebee fire on new subscriptions?
Short answer: Drop the "Chargebee → Subscription Created" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Chargebee, 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
Subscription Created
When the matching event happens
watch for subscription createdwhen a new subscription is creatednew subscriptionwhen subscription createdsubscription addedon subscription creatednew subscription created
What this trigger returns
for the curiousYou 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.
{"id": "sub_123","status": "active","plan_id": "basic-monthly","created_at": 1712835600,"customer_id": "cust_123"}
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.
| Field | Type | Example |
|---|---|---|
| id | string | "sub_123" |
| status | string | "active" |
| plan_id | string | "basic-monthly" |
| created_at | number | 1712835600 |
| customer_id | string | "cust_123" |
Pairs with
Drop these actions after Subscription Created.
FAQ
Questions about Subscription Created.
How does the Subscription Created trigger work in Chargebee?
Fires on new subscription creation. Payload includes plan, customer, billing cycle, trial dates. The base hook for SaaS onboarding: provision product access, welcome sequence, notify CS for high-value plans.
Is the Subscription Created trigger real-time?
Yes. Subscription Created uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Chargebee.
What data does Subscription Created return?
The full event payload from Chargebee. 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 Subscription Created 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 Chargebee admin permissions to use Subscription Created?
For most Chargebee accounts a standard user can authorize the trigger. Some Chargebee plans require an admin to enable third-party webhooks. Check Chargebee's docs if the trigger fails to register.
More triggers
Other Chargebee triggers.
Trigger
Payment Succeeded
Fires when a payment is successfully captured against an invoice. Payload includes amount, currency, payment method, customer, the cleared invoice. The standard revenue-tracking hook for accounting sync and customer-success "they paid" workflows.
TriggerSubscription Cancelled
Fires when a subscription cancels — by customer self-serve, by CS team, or scheduled. The churn hook: revoke product access at period end, trigger the exit survey, log to customer-success churn dashboard.
TriggerSubscription Renewed
Fires when a subscription auto-renews at the end of its billing period. Useful for "they renewed → thank them, ask for testimonial, log to retention tracking" workflows that capture the customer-satisfaction signal.
Build a workflow on this trigger.
One trigger. 3+ downstream actions. Zero glue.
