# 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