Connecting Sharetribe

Connect your Sharetribe marketplace to Toppal to enable affiliate referral tracking.

Written By Tyler

Last updated 2 days ago

Connecting Sharetribe

The Sharetribe integration is the foundation of Toppal's referral tracking.

Plan requirement: Available on all paid plans.

Prerequisites

  • A Sharetribe marketplace with an active subscription

  • Access to Sharetribe Console

  • Admin access to your Toppal account

Step 1: Connect Integration API

  1. Navigate to Admin > Integrations > Sharetribe.

  2. Enter your Sharetribe Integration API Client ID and Client Secret.

  3. Click Continue to validate.

Where to find credentials: Sharetribe Console > Build > Applications > Integration API.

Step 2: Set Up Referral Source

  1. In Sharetribe Console, go to Build > Users > User Types.

  2. Select your user type and click Add a new referral source.

  3. Configure exactly (case-sensitive):

    • Referral source name: Toppal

    • URL parameter name: referrerID

  4. Return to Toppal and confirm.

Step 3: Choose Marketplace Type

Sharetribe Web Template (Lite/Pro)

Referral tracking is handled automatically. No code changes needed.

Custom Code (Extend)

You need to implement referral tracking:

  • If on Web Template v11.1.0+, confirm tracking is implemented

  • Otherwise merge Sharetribe PR #826 or implement manually: capture referrerID from URL, store in browser, pass during signup

Step 4: Complete

  • Web Template users: Setup is complete automatically.

  • Custom Code users: Confirm your tracking implementation is live.

After Setup

  • Events sync automatically every 5 minutes

  • View sync history on the Sharetribe integration page

  • You can now activate programs