> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How Customer Sync Works

> The data flow between Stripe and Bizzy Customers

Customer sync is **Stripe → Bizzy**, scoped to your primary business's connected
Stripe account.

## What triggers a sync

* **Initial sync** runs when you first connect Stripe — existing customers are
  imported in a batch.
* **Ongoing sync** runs on Stripe webhooks. New customers and updates to
  existing customers propagate to Bizzy automatically.

There is no manual "sync now" button today. Webhook propagation is usually
within seconds.

## Sync scope

* Only the Stripe account you linked via
  [Stripe Connect](/user-guide/businesses/stripe-connect) is synced.
* The linked account is scoped to your **primary** business. In a multi-business
  setup, the other businesses' customers don't appear here.

## What gets synced

* **Name**
* **Email**
* **Customer ID** (`stripeCustomerId`, used to detect that a row is synced)
* **Customer creation date** (displayed as "Customer since")

Stripe-specific metadata that Bizzy doesn't surface today (tax IDs, shipping
addresses, metadata keys) remains in Stripe. Contact support if you need a
specific field pulled through.

## Detecting sync status

* **Synced** customers have a green **Stripe** badge in the list and a populated
  `stripeCustomerId`.
* **Not synced** customers are rows added in Bizzy directly — today this path is
  rare because the UI doesn't expose customer creation, but some API/MCP callers
  do.

The **Sync filter** in the list lets you narrow to synced or not-synced.

## What does NOT sync

* **Bizzy → Stripe.** Edits in the Customers list do not push back to Stripe.
  Customer data in Stripe is authoritative.
* **Deletion.** Deleting a customer in Stripe does not delete the Bizzy record
  automatically — it stays visible until support removes it (or a future sync
  pass handles soft-deletes).

## When sync breaks

| Symptom                                   | Likely cause                         | Fix                                                                    |
| ----------------------------------------- | ------------------------------------ | ---------------------------------------------------------------------- |
| New Stripe customer not showing           | Webhook delivery delay or failure    | Wait a few minutes; if still missing, check Stripe's event log         |
| Stripe disconnected                       | OAuth revoked                        | Reconnect from [Stripe Connect](/user-guide/businesses/stripe-connect) |
| Initial import didn't populate everything | Rate limits on large Stripe accounts | Contact support                                                        |

## Next steps

<CardGroup cols={2}>
  <Card title="Customers list" icon="user-tie" href="/user-guide/customers/index">
    Back to the list view
  </Card>

  <Card title="Stripe Connect" icon="credit-card" href="/user-guide/businesses/stripe-connect">
    Link or relink Stripe
  </Card>
</CardGroup>