Migrate from Sharetribe to Sunoblack

Sunoblack is API-compatible with the Sharetribe Marketplace API. Your existing web template works by changing the API base URL — no rebuild required.

Key fact: If your marketplace runs the Sharetribe web template (FTW or the newer templates), changing REACT_APP_SHARETRIBE_SDK_BASE_URL from https://flex-api.sharetribe.com to https://api.sunoblack.com and updating your credentials is all that's needed to test the switch.

Migration in 5 steps

  1. Create a test marketplace on Sunoblack.
    Sign up at sunoblack.com/signup. You get a test environment immediately — no credit card required. You'll receive a Client ID, Client Secret, and API base URL.
  2. Point your web template at Sunoblack.
    In your .env file, set:
    REACT_APP_SHARETRIBE_SDK_CLIENT_ID=<your-sunoblack-client-id>
    REACT_APP_SHARETRIBE_SDK_BASE_URL=https://api.sunoblack.com     Rebuild your frontend. The UI should load and connect to your Sunoblack marketplace.
  3. Test end-to-end on the test environment.
    Sign up a test user, create a listing, run a transaction. The Sunoblack test environment uses Stripe test mode, so no real money moves. Verify your custom transaction processes, extended data, and search schemas all work.
  4. Migrate your data.
    Use the Sharetribe Integration API to export your users and listings. Sunoblack's migration tool accepts Sharetribe export format and imports users, listings, images, and custom data via the Sunoblack Partner API. This step is guided.
  5. Cut over DNS.
    Configure your custom domain in the Sunoblack Owner Dashboard. Update your DNS CNAME to point to Sunoblack. Update Stripe webhook endpoints to the new domain. The cutover window is typically under an hour.

What migrates automatically

  • User accounts (email, display name, profile data)
  • Listings (title, description, pricing, extended data, images)
  • Transaction processes (your custom EDN process definitions import directly)
  • Assets (listing types, user fields, branding config)
  • Search schema (custom search fields)

What needs manual work

  • Active transactions — in-flight transactions on Sharetribe need to complete before migration. Plan a migration window after open transactions close.
  • Stripe Connect accounts — providers' connected accounts need to reconnect to your new Stripe account on Sunoblack (this is a Stripe platform account constraint, not specific to Sunoblack).
  • Emails and notifications — update notification templates to reference sunoblack.com and configure your custom From address in the Owner Dashboard.

Frequently asked questions

Do I need to rebuild my web template when migrating?

No. Sunoblack is API-compatible with the Sharetribe Marketplace API. Your existing web template works by changing the API base URL and credentials. No code changes are required for the standard migration path.

Can I migrate my existing users and listings?

Yes. Sunoblack's migration tool accepts data exported from the Sharetribe Integration API and imports it into your new marketplace. User accounts, listings, and images can all be migrated.

How long does a Sharetribe migration take?

The web template config change takes minutes. A full data migration typically takes a few hours depending on data volume, most of which is automated. DNS cutover takes effect in minutes to hours depending on your TTL.

Will there be downtime?

Most operators run Sunoblack in parallel under a test subdomain until they're confident, then cut over DNS for a near-zero-downtime switchover. During the DNS propagation window (typically under 1 hour), users are distributed between both platforms.

What happens to my Stripe payments after migration?

Sunoblack uses the same Stripe integration model as Sharetribe. Your existing Stripe account reconnects to the new marketplace. Existing payment methods carry over without requiring users to re-enter card details.

Start a test migration now

Create a free test marketplace and verify your web template works before committing. No credit card, no lock-in.

Start free Migration tool