Connect Stripe to bring your Stripe customers into Simplesat, so you can send them email surveys. Each customer's subscription status, subscription dates and Stripe metadata come in with them as customer attributes. Audiences can use those attributes, so you could survey only customers with an active subscription, for example.
All of this runs through one switch, Sync customers from Stripe to Simplesat, under Account-wide integrations on the Stripe page. It has no settings. It only reads from Stripe, and nothing is written back.
Before you start
The Stripe integration is available on every Simplesat plan.
In Simplesat, you need the Manage integrations permission to connect Stripe and switch the sync on. Owner and Admin have it by default.
In Stripe, you'll create a restricted API key with read-only permissions: Customers: Read and Events: Read.
If your security team asks what a connected tool can read and write, point them to Integration security, permissions and data flow.
Connect Stripe
In Stripe, go to Developers → API keys and click Create restricted key.
Select Providing this key to another website and click Continue.
Name the key Simplesat, enter
https://integration.simplesat.ioas the URL, select Customize permissions for this key and click Continue.Set Customers to Read and Events to Read, then click Create key.
Copy the key.
In Simplesat, on the Integrations page, open Stripe and click Authenticate.
Paste the key into API Key and click Authenticate.
When the page shows Authenticated with Stripe, click Activate integration on Sync customers from Stripe to Simplesat.
Stripe customers in Simplesat
The Stripe sync follows the rules all contact syncs share, starting with one customer per email address. Contact sync from a connected tool explains them, including how attributes are replaced and what happens when you delete a customer in your tool.
What each customer brings in
Each Stripe customer comes into Simplesat with:
Email address, name and Stripe customer ID.
The customer's own Stripe metadata, each key as a customer attribute.
From their subscription, these customer attributes:
subscription_status,subscription_created,subscription_current_period_startandsubscription_current_period_end. The dates are in ISO 8601 format, for example 2026-10-04T15:31:59.000Z.The subscription's metadata and its plan's metadata, each key as a customer attribute.
If a customer has more than one subscription, the subscription attributes hold the values of the last one Stripe lists for them. Stripe customers without an email address aren't added.
Heads up: Each run replaces all of a synced customer's custom attributes with the ones from Stripe. That includes attributes from a CSV import or added any other way. If you want to keep a detail on a Stripe customer, store it in their Stripe metadata.
Which customers come in, and when
The sync runs once a day, at the time of day you switched it on. Each run reads the Stripe customers whose details changed in Stripe in the past 30 days, and adds or updates each one in Simplesat.
Heads up: Switching the sync on doesn't bring in all your Stripe customers. It brings in the ones that changed in the past 30 days. A customer that hasn't changed since then comes in the next time it changes in Stripe. Turning the sync off and on again, or resetting it, doesn't change this.
To add the customers the sync hasn't picked up, import them from a CSV file, as described in Customers.
The import matches on email address, so nobody is duplicated. The sync updates those customers the next time they change in Stripe. When it does, it replaces the attributes you imported with the ones from Stripe.
Change the Stripe key or account
To use a new key or connect a different Stripe account, go to the Stripe page in Simplesat:
Click Revoke access.
Click Authenticate and paste the new key.
Click Activate integration on Sync customers from Stripe to Simplesat. Connecting again doesn't switch the sync back on, so don't skip this step.
If you delete or roll the key in Stripe, the sync stops, but the page still shows Authenticated with Stripe. Create a new restricted key as described in Connect Stripe, then reconnect with the steps above.
Troubleshooting
Only some of my Stripe customers came into Simplesat
Each run reads only the Stripe customers whose details changed in the past 30 days, so customers that haven't changed in that time aren't read. Turning the sync off and on, or resetting it, doesn't change this. Customers without an email address aren't added at all.
To bring in the rest, import them from a CSV file. The import matches on email address, so nobody is duplicated.
Custom attributes on my Stripe customers disappeared
Each run replaces all of a synced customer's custom attributes with the ones from Stripe. Attributes you added in Simplesat or through a CSV import are removed the next time the sync reads that customer. Keep the details you need in the customer's Stripe metadata, and they'll come in as attributes.
A customer's subscription_status doesn't match what I see in Stripe
If the customer has more than one subscription, the subscription attributes hold the values of the last subscription Stripe lists for them. That may not be the one you're looking at. The values are also only as current as the last time the sync read the customer.
My Stripe sync stopped working, but the page still says Authenticated with Stripe
Simplesat checks the key only when you connect. If the key is later deleted, rolled or loses a permission in Stripe, the sync fails, but the page still reads Authenticated with Stripe. Create a new restricted key. Then, on the Stripe page, click Revoke access, then Authenticate to paste the new key, then Activate integration.
FAQ
Does the Stripe integration change anything in Stripe?
No. The key you create has only read permissions, and the sync only reads customers. Nothing is written to Stripe.
Can I use Stripe subscription details in audience rules?
Yes. Subscription status and dates come in as customer attributes, and so does your Stripe metadata. Audience rules can use them. An attribute shows up in the rule's list once at least one customer has it.
If I delete a customer in Stripe, is it deleted in Simplesat?
No. The sync never deletes a customer in Simplesat.