Organizations

Organizations are the top-level entity in RefRef's multi-tenancy structure. Each organization can contain multiple products and team members with role-based access control.

How It Works

Create organization: Set up your organization during onboarding
Add products: Create one or more products under your organization
Invite members: Add team members with appropriate roles (owner/admin)
Manage settings: Update organization name, logo, and metadata

All products, programs, and participants belong to an organization. You must create an organization before you can create products.

Creating an Organization

Organizations are created during the initial onboarding flow when you first sign up for RefRef.

Organization fields:

Name (required): Your company or organization name
Slug (auto-generated): Unique URL-friendly identifier
Logo (optional): Organization logo URL
Metadata (optional): Custom JSON metadata for your use

The organization slug is automatically generated and used in URLs and API references.

Multi-Tenancy Structure

RefRef uses a hierarchical multi-tenancy model:

Organization (top level)
  ├── Products (1 or more)
  │     ├── Programs
  │     ├── Participants
  │     └── Events
  └── Members (team users with roles)

Key concepts:

One active organization: Users can belong to multiple organizations but work in one at a time
Organization-scoped data: All products, programs, and participants are scoped to an organization
Role-based access: Organization members have roles that control permissions

Member Management

Add team members to your organization and assign roles:

Roles:

Owner: Full control over organization, products, and members
Admin: Can update organization settings and manage products

Member operations:

View all organization members in the dashboard
Invite new members via email (feature in development)
Remove members (owner/admin only)

Only owners and admins can update organization settings. Regular members have read-only access to organization information.

Updating Organization Settings

Update your organization name and logo through the RefRef dashboard:

Navigate to Settings → Organization
Update the organization name or logo URL
Click Save Changes

What you can update:

Name: Organization display name (1-100 characters)
Logo: URL to organization logo image (must be valid URL)

Organization slug cannot be changed after creation. Contact support if you need to change your slug.

Products - Create and manage products within your organization
Programs - Set up referral and affiliate programs