Skip to main content
Fluid gets you from zero to a fully attributed, payment-ready storefront faster than any traditional e-commerce stack. Follow these steps to create your account, connect the FairShare attribution SDK to your website, and confirm everything is working with a live API call. The whole process takes under 10 minutes.
1

Create your account

Sign up for a Fluid account at admin.fluid.app/sign-up. Choose your plan, enter your business details, and verify your email address. Once your account is active, you’ll land in the Fluid Admin dashboard — your control centre for storefronts, reps, orders, and settings.
2

Get your API token

Navigate to Admin Settings → Developer inside the dashboard. Generate a new API token and copy it to a secure location. You’ll use this token to authenticate every request to the Fluid API. Treat it like a password — never commit it to source control or expose it in client-side code.
3

Install the FairShare SDK

Paste the following script tag into the <head> of every page on your website. FairShare will automatically begin tracking rep referral routes, cookies, and fingerprints from the moment it loads.
FairShare works on any domain — including sites you don’t fully control — so you can attribute sales from affiliate pages, microsites, and partner storefronts without additional configuration.
4

Make your first API call

Verify your token and connection by fetching your product catalogue. Run the following command in your terminal, replacing YOUR_API_TOKEN with the token you copied in Step 2.
A successful response returns a paginated JSON array of your products. If you receive a 401 Unauthorized error, double-check that you copied the full token and that it hasn’t been revoked in the dashboard.
5

Configure webhooks

Webhooks let Fluid push real-time events — new orders, commission updates, customer sign-ups — directly to your server instead of requiring you to poll the API. In the dashboard, go to Admin Settings → Developer → Webhooks, add your endpoint URL, and select the event types you want to receive. Fluid signs every webhook payload with an HMAC signature so you can verify requests are genuine.
Not ready to point requests at the live API yet? Use the mock server at docs.fluid.app/_mock/docs/apis/swagger/ to explore endpoints and test request shapes without touching real data.

​
What’s next?

Now that your account is live and FairShare is installed, explore how to secure your integration and build out your full API workflow.

Authentication Guide

Learn how API tokens, OAuth flows, and webhook signatures work in Fluid.

API Overview

Browse the full Fluid REST API reference — products, orders, customers, commissions, and more.