Skip to content
OpenPartner docs

Brand quickstart

By the end of this you’ll have:

  1. A brand workspace at app.openpartner.dev/t/<your-slug>
  2. A program with commission rules
  3. One invited partner with a working share link
  4. The OpenPartner SDK installed on your site so conversions get attributed

Total time: 5–10 minutes.

1. Sign up

Go to app.openpartner.dev and click Sign up as a brand. You’ll need:

  • Your email
  • A name for your brand (visible to partners + creators)
  • A slug — the URL path your workspace lives at, e.g. acme → app.openpartner.dev/t/acme. Lowercase, no spaces.

We email you a magic link to confirm. Click it and you’ll land in your new workspace.

Add a logo (optional, ~30 seconds). Admin → Settings → Brand info → Upload logo. PNG/JPEG/WebP up to 2 MB; square renders best. The logo replaces the default icon in the partner-portal sidebar and shows up next to your brand name across the workspace UI.

2. Create a program

A program is the commission rule applied to clicks → conversions for a given destination. Most brands have one or two programs; some have many (one per product line, country, etc.).

In the sidebar: Admin → Programs → New program. Fill in:

  • Name — internal label
  • Destination URL — where partner share-links land (e.g. your homepage, a specific landing page)
  • Allowed deep-link domains (optional) — comma-separated hosts. Partners can override the destination on their share-link as long as the override matches one of these. Leave blank to lock the destination to what you set above.
  • Rule — Percent or Fixed. For SaaS, 20% recurring is typical. For ecommerce, 15% one-time is common.
  • Attribution window — how many days a click stays attributable. 60 days is the default and what most brands use.
  • Attribution model — last-click is the default. Hover the ? icon for the others (first-click, linear, position).
  • Starts / Ends — leave blank to start immediately and run forever, or schedule a window for promo periods.

Click Create program. It’s now live.

3. Invite a partner

In the sidebar: Admin → Partners → Invite partner. Drop in their name + email. They’ll get a magic-link email to claim their account.

By default, the invite grants access to all current programs. If you want to scope a partner to a specific program (e.g. a VIP partner who gets a unique higher-cut deal), uncheck the box and pick the programs explicitly.

Once they sign in, they’ll see their share link under Links and can start sharing it.

4. Install the SDK

Install via npm in your marketing site / app:

Terminal window
npm install @openpartner/sdk

Initialize once + track on every page load:

import { OpenPartner } from '@openpartner/sdk';


export const op = new OpenPartner({ siteId: 'site_xxx' });
op.track();  // reads ?cref= from the URL, sets the first-party cookie

When a user signs up, identify them so the click → user link sticks:

op.identify(user.id, { email: user.email });

When revenue happens (signup, trial start, subscription, invoice), report it:

op.event('subscription_created', { amount: 4900, currency: 'USD' });

That’s the full integration. Full details: SDK install and tracking events.

5. Watch attribution land

When the partner’s first click → signup → revenue path completes:

  • Click is recorded in Admin → Review queue
  • Conversion event is attributed to the partner
  • Commission is computed using your program rule and shows up in Admin → Partners → [partner] → Commissions as accrued

You approve → it becomes approved → the next payout run pays it out via Stripe Connect.

What’s next