Stripe
Sync billing data read-only and trigger automations on Stripe events
The Stripe integration syncs a read-only mirror of your billing data into Modem: customers, subscriptions, products and prices, invoices, charges, disputes, and refunds. Billing events become automation triggers, and the Modem Agent can query billing data alongside your conversations and act on what it finds.
Prerequisites
- Administrator access to the Stripe account you want to connect
- Admin or owner role in your Modem organization
Setup
Start the connection
Go to Settings → Integrations → Stripe in your Modem dashboard and click Connect Stripe.
Install the Modem app
You’ll be redirected to Stripe to install the Modem app on your account. Review the read-only permissions and approve the install.
After installation, Modem automatically begins a historical backfill of your billing data and starts receiving new billing events in real time. The settings page shows Initial sync in progress until the backfill completes.
What Gets Synced
Modem keeps a read-only mirror of the following Stripe objects, updated in real time via webhooks with automatic reconciliation:
- Customers: names and emails, so billing activity can be matched to Modem people and companies
- Subscriptions: status, plan, trial dates, and cancellation state
- Products and prices: so automations and the agent can name the plan and amount involved
- Invoices: status, amounts, due dates, and payment attempts
- Charges and refunds: payment outcomes and failure codes
- Disputes: status, reason, and evidence deadlines
Automation Triggers
Connecting Stripe adds billing events as automation triggers. When an event fires, its details are automatically added to your automation’s prompt as context.
| Trigger | Fires when |
|---|---|
| Customer is created | A new customer appears in Stripe |
| Subscription starts | A new subscription is created |
| Subscription is canceled | A subscription is canceled |
| Trial is ending | A subscription trial is about to end |
| Payment fails | An invoice payment attempt fails |
The initial backfill never fires automation triggers, so connecting an account with years of history won’t flood your channels.
Example automations
Agent Capabilities
The Modem Agent can query your synced billing data alongside conversations, topics, people, and companies, and act on what it finds: posting summaries, alerting channels, or creating tickets.
Example prompts
Troubleshooting
The settings page shows 'Initial sync in progress'
The historical backfill runs in the background after connecting and can take a while for accounts with a lot of history. New billing events are processed in real time even while the backfill is running.
The connection shows an error or asks to reconnect
Stripe access tokens are refreshed automatically. If the connection shows an error or a reconnect prompt, click Reconnect on Settings → Integrations → Stripe to re-authorize. This is safe and won’t duplicate data.
Automations aren't firing on billing events
Verify the automation is Enabled and its trigger matches the event you expect. Note that historical data imported during the initial backfill never fires triggers. Only new events after connecting do.
Billing data looks stale
Data updates in real time via webhooks, with a periodic reconciliation pass that catches anything missed. If a specific object looks out of date for more than a few minutes, contact support@modem.ai.
Disconnecting
To disconnect Stripe:
- Go to Settings → Integrations → Stripe
- Click Disconnect
This revokes Modem’s access to your Stripe account and stops new data from syncing. You can also uninstall the Modem app directly from your Stripe dashboard under Settings → Installed apps. Historical data remains in Modem after disconnecting.