Import clients from Stripe
How do I import clients from Stripe?
Open Clients → Add Client → Stripe, then select Connect Stripe. Synup requests read-only Stripe access and pulls customers with active subscriptions (up to 500) into a review grid. Choose the records to create, correct required fields, resolve duplicates, and select Import, which shows how many rows it will create, for example Import 3 selected. Synup disconnects Stripe automatically after a successful import. The import creates clients only: it adds no locations and sends no portal invitations.
Key facts
| Where it lives | Clients → Add Client → Stripe |
| What Stripe access does | Reads active-subscription customers for this import; it does not charge customers or modify Stripe data |
| What the final action does | Creates the selected Synup client records. No locations are created and no portal invitations are sent |
| Limit | Active-subscription customers only, up to 500 per connection, each customer once |
| Defaults | Primary representative is you; service is Listings |
| Connection lifecycle | Synup disconnects after a successful import and when no active customers are found |
Before you connect
- Use the Stripe account that contains the active subscription customers you intend to manage in Synup.
- Confirm whether you are connecting Stripe test mode or live mode; the review header shows the mode and the end of the connected account ID.
- Decide who should be the primary representative for imported clients.
- Connecting Stripe saves a connection in Synup, and importing creates real client records, even though the access to your Stripe data is read-only.
Steps
Open Clients and select Add Client.
Select the Stripe tab, then choose Connect Stripe. Complete Stripe's authorization screen using your agency's billing account.
When you return, verify the connection label. It identifies test or live mode and shows the final characters of the Stripe account ID.
Review the customers Synup found. Only customers with an active subscription are pulled into this flow, so customers whose subscriptions are trialing, past due or cancelled do not appear. Synup lists up to 500 customers.
For each client you want to import, review or edit the required Business name, required Primary representative, and at least one Service. The representative defaults to the current user and the service defaults to Listings. Email is optional but must be valid when present; notes and client custom fields are optional. If a Stripe customer's name looks like a person's name, it is placed in the contact name and Business name is left blank for you to fill in.
Exclude a row when it should remain in Stripe without becoming a Synup client. The separate removal checkbox drops it from the working review grid.
Resolve duplicates before importing. A Stripe customer whose email or business name matches an existing client, including an archived one, is flagged Duplicate of that client. It starts unchecked and reads Will skip — existing client kept as-is, so the existing client is left unchanged. Choose Import as new anyway only when a second client is genuinely intended.
Select Import. The button shows the number of rows it will create, such as Import 3 selected, and stays unavailable until at least one selected row is valid.
Wait for the imported count. Synup disconnects Stripe automatically after success, and the new clients appear in the Clients workspace. They have no locations yet. Add them next, as described in add a client.
What you'll see when it's done
- A confirmation with the number of clients imported
- New client records in Clients
- Duplicate rows skipped when you leave them unchecked, so the existing clients are left as they were
- Stripe disconnected from the import session
Watch out for
Questions people ask
Does importing change anything in Stripe?
No customer, subscription or charge is changed. Synup reads eligible customers and creates records only in Synup. The temporary Stripe connection is removed after a successful import or an empty result.
What happens to a duplicate?
A flagged duplicate is skipped by default: the existing client is left unchanged and none of the Stripe fields are copied onto it. Choose Import as new anyway to create a second client. If a new client's name matches an existing or archived client, Synup refuses the import and names the clash, so rename the row or restore the archived client.
Why is the Import button disabled?
Select at least one row, then make sure each selected row has a business name, a primary representative, at least one service, and a valid email if an email is present.
Can I disconnect before importing?
Yes. Use Disconnect in the connected review header. This abandons the current Stripe review session without creating clients.
Next
Use searching and saving client views to review the imported set. Then open understanding client health to see which imported records have enough measured data for a score.
