Access is read-only. Modem connects through an official Stripe App using OAuth. There are no API keys to copy, and you can revoke
access from your Stripe dashboard at any time. Modem never sees card numbers or payment credentials.
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.
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
If your install grants test-mode access only, the settings page shows a Test mode badge on the connection.
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 |
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 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
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
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
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.dev.
Disconnecting
To disconnect Stripe:- Go to Settings → Integrations → Stripe
- Click Disconnect
Related
Automations
Run the agent on a schedule or when billing events fire.
The Modem Agent
Query your data and take action from one conversation.
Companies & People
How Modem models the people and companies behind your revenue.