# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.twinr.dev/plugins/sharetribe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.