Skip to main content
Connecting Swell to Vortex IQ gives the AI OS a live read on your Swell data, feeding the Nerve Centre dashboard, Vortex Mind diagnostics, and Ask Viq.

​
What data Vortex IQ reads from Swell

  • Order
  • Subscription
  • Product
  • Account
  • Invoice
  • Payment
  • Refund

​
How to connect

Swell uses credential-based authentication rather than OAuth. You provide these values directly rather than approving a redirect.
1

Open Connected Sources

In your Vortex IQ workspace, go to Settings → Connected Sources. You need Admin role in the workspace to connect sources.
2

Find the Swell card

Locate the Swell connector card and click + Connect. The connector drawer opens with a credential form.
3

Gather your credentials from Swell

You will need:
  • Store ID: Your Swell store identifier (the subdomain of .swell.store). Used as the Basic auth username and the host prefix.
  • Secret API Key: Generate in Swell dashboard → Developer → API keys → Secret key. Full backend access - shown once on creation.
4

Enter credentials in Vortex IQ

Paste each value into its matching field in the connector drawer.
5

Verify and connect

Click Verify and Connect. Vortex IQ makes a test API call to validate the credentials before saving them.
Vortex IQ only ever requests read-only access. Where Swell offers scoped or read-only API keys, use one.

​
Available KPI cards

Vortex IQ populates 42 Nerve Centre cards from your Swell data. See the Swell KPI card reference for the full list with definitions, calculations, and sentiment bands.

​
Troubleshooting

Re-check each value against the Swell developer console for typos or trailing whitespace. If a scope or permission is missing, Swell will typically return a 401 or 403 on the verification call rather than a generic failure.
Allow time for the first sync to complete; large accounts can take longer. If cards are still empty after an hour, disconnect and reconnect to confirm the credentials were saved correctly.