Sharetribe

This guide explains how to connect your Sharetribe marketplace with your Twinr app using secure credentials, verify the connection, and automate workflows using Zapier.

---

Prerequisites

Before starting, ensure the following:

• You have an active Premium plan in Twinr

• You own or manage a Sharetribe marketplace

• You have admin access to:

  • Twinr Builder Portal

  • Sharetribe Console

  • Zapier account (optional, for automation)

---

Step 1: Access Sharetribe Integration in Twinr

1. Log in to the Twinr Builder Portal

2. Navigate to: Add-Ons → Integrations

3. Locate Sharetribe in the plugin list

Plugin Status Indicators

• Disconnected (Grey): Sharetribe is not yet connected

• Connected (Green): Integration is active and verified

⚠️ Sharetribe is a Premium-only plugin. If your plan is downgraded, the integration will automatically disconnect.

---

Step 2: Get API Credentials from Sharetribe Console

To connect Sharetribe with Twinr, you need a Client ID and Client Secret.

Generate Credentials

1. Log in to the Sharetribe Console

2. Go to: Advanced → Applications

3. Click Create New Application

4. Copy the following:

   • Client ID

   • Client Secret

🔐 Keep these credentials secure. Do not share them publicly.

---

Step 3: Connect Sharetribe in Twinr Builder Portal

1. In Twinr → Integrations → Sharetribe

2. Enter:

   • Client ID

   • Client Secret

3. Click Connect

Connection Validation

• ✅ Success Message: Credentials are valid and connected

• ❌ Error Message: Invalid Client ID or Secret

Once validated:

• Plugin status changes to Connected

• Integration becomes active immediately

---

Step 4: Verify Integration Status

After successful connection:

• Sharetribe plugin status shows Connected

• Marketplace data is now available for app workflows

• You can proceed with automation and event handling

If the plan is downgraded from Premium → Standard/Basic:

• Integration automatically switches to Disconnected

• API access is revoked for security

---

Step 5: Connect Sharetribe with Zapier (Optional)

Zapier allows you to automate workflows between Sharetribe and other tools (CRM, email, analytics, etc.).

Setup in Zapier

1. Log in to Zapier

2. Click Create Zap

3. Choose Sharetribe as the trigger app

4. Authenticate using your Sharetribe account

5. Select an event, such as:

   • New User Created

   • New Listing Published

   • New Order Placed

---

Step 6: Use Sharetribe Data in Twinr App

Once connected:

• Marketplace users can interact inside your Twinr app

• Orders, listings, and profiles sync via Sharetribe APIs

• Zapier can trigger action like "Push notifications"

---

Common Errors & Troubleshooting

Invalid Client Credentials

• Ensure Client ID and Secret are copied correctly

• Check if credentials belong to the correct Sharetribe marketplace

Plugin Auto-Disconnected

• Verify your subscription is still Premium

• Reconnect after upgrading your plan

Zapier Not Triggering

• Confirm Sharetribe trigger event is active

• Test Zap manually inside Zapier

---

Security & Best Practices

• Rotate API credentials periodically

• Disconnect integration if no longer needed

• Use Zapier filters to avoid unnecessary triggers

• Limit admin access to Sharetribe Console

---

Summary

Step	Action
1	Enable Sharetribe plugin in Twinr
2	Generate Client ID & Secret in Sharetribe
3	Connect credentials in Twinr
4	Verify Connected status
5	(Optional) Automate with Zapier
6	Use marketplace features in your app

---

Need Help?

If you face any issues during setup:

• Check your subscription plan

• Re-verify credentials

• Contact Twinr Support with screenshots and error messages