Skip to main content
Back to docs
Plugin onboarding

How plugin onboarding works

The fastest way to get a Flowgration CRM up and running is to install our plugin in your store. The plugin scans your data, sends a summary to Flowgration, and an entire CRM — pipeline, stages, products, orders, contacts — is built for you in the background. No API keys to copy. No manual mapping for the standard fields. Here's exactly what happens.

Step 1

Install the plugin

Install Flowgration CRM from WordPress.org (or upload the .zip from flowgration.com/integrations), activate it, then click the new Flowgration entry in your wp-admin sidebar. Shopify and other platforms follow the same pattern via their respective app stores.

Step 2

Choose "I'm new to Flowgration"

Pick the "I'm new to Flowgration" option, type the email you want as the owner, and click Connect. The plugin sends a CRM summary to Flowgration's backend — that's counts only, no customer rows — plus the discovered schema (form fields, post types, WooCommerce meta keys).

You do not need to have a Flowgration account yet. The plugin creates one for you in the next step.

Counts only
We send counts (e.g. 432 products, 1,200 orders). No customer rows leave your site yet.
Schema scan
Form plugins, custom post types and Woo meta keys are detected so we know what's available.
No account needed
You do NOT need to sign up first. The plugin creates the account for you.
Step 3

Click the magic-link in your email

Open your inbox and click the activation link Flowgration just sent you. While you wait on the loading screen, the backend builds your CRM in the background: a pipeline with sensible stages, custom fields tailored to your store, and the products/orders schema — all in 10-30 seconds.

Step 4

Set a password

Once the CRM is ready, Flowgration asks you to set a password. This is so you can sign back in later without needing another magic-link. You're already logged in as the owner — the password is just for next time.

Step 5

The CRM is now yours

Pipeline, stages, products and orders schema — all configured automatically. The plugin's API key was passed back to your WordPress site in the same request, so it's already saved in the plugin's settings.

You do not need to paste an API key anywhere manually.

Pipeline
Stages auto-generated from your business profile.
Custom fields
Created based on the schema we detected.
Products + orders
Schema ready, just waiting for the backfill.
Step 6

Historical backfill starts automatically

Flowgration pings your WordPress site at wp-json/flowgration/v1/kick-backfill and your historical customers, orders and products start streaming in. Track progress on the integrations page — there's a per-source progress bar for each.

Expect roughly 5-10 minutes for 500-1,000 records on a healthy host. The job is resumable, so worker restarts or network blips don't lose progress.

Step 7

Confirm your field mappings (optional)

Most fields auto-map. To see what's captured, open Custom CRM → Field Maps and look at the green "Automatically mapped" chip strip at the top of each tab — those are the fields Flowgration grabs on every sync.

Add a custom field only for store-specific extensions Flowgration doesn't know about out of the box (an unusual Woo plugin, a custom metadata key, etc.).

Step 8

Live sync from here on

From this point on, every new order, customer signup, product change, abandoned cart and form submission flows into your CRM in real time — typically within 30 seconds of the event happening on your store.

Frequently asked questions

Do I need to paste an API key into the plugin?

No. The plugin receives the API key automatically via the magic-link callback. You only need to paste a key manually if you're connecting an existing Flowgration org to a new store (Flow A in the WordPress docs).

I deleted my org and re-connected — why is my old data not back?

Org deletion is permanent: every CRM row is wiped immediately and unrecoverably (this is by design for GDPR). Re-connecting creates a fresh CRM. Use the Backfill button in /app/integrations to re-import historical data from your store.

The backfill is stuck at X%. What now?

Open /app/integrations and find the "Re-import historical data" button on the stuck source. The job is idempotent — re-running won't create duplicates.

Where do I see imported contacts?

/app/crm/contacts. Every WooCommerce customer and every form submitter becomes a Contact row.

Where do I see imported orders?

/app/orders if you're in ecommerce mode, or /app/crm/opportunities if you don't have ecommerce mode enabled — orders are stored as opportunities in that case.