Skip to content
Esc
↑↓navigate↵open⌘Jpreview
On this page

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

PromptWhen a subscription is canceled, review this customer's recent conversations and post a churn analysis to #retention
PromptWhen a trial is ending, check for open topics from this customer and alert #sales
PromptWhen a payment fails, alert #billing with the invoice details and any recent conversations with this customer

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

PromptWhich paying customers reported bugs this month?
PromptList subscriptions that canceled in the last 30 days and summarize what each customer was talking about beforehand
PromptHow much MRR is on trials ending in the next two weeks?
PromptFile a ticket for the bug our highest-revenue customer reported last week, and note their plan in the description

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:

  1. Go to Settings → Integrations → Stripe
  2. 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.

Was this page helpful?