Skip to main content

Sharetribe

Sharetribe is a marketplace platform for building and running online marketplaces that connect buyers and sellers. Its Integration API provides programmatic access to marketplace data, allowing you to manage users, listings, transactions, bookings, reviews, messages, and events. The Nexla connector uses OAuth 2.0 client credentials to read from and write to the Sharetribe Integration API.

Sharetribe icon

Power end-to-end data operations for your Sharetribe API with Nexla. Our bi-directional Sharetribe connector is purpose-built for Sharetribe, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Sharetribe or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Sharetribe workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Sharetribe credential, you need to obtain a Client ID and Client Secret for an Integration API application from your Sharetribe Console. The Integration API uses the OAuth 2.0 client credentials flow, where these two values are exchanged for an access token that authenticates each API request.

To obtain your Sharetribe credentials, follow these steps:

  1. Sign in to your marketplace in the Sharetribe Console using your administrator account.

  2. In the Console, navigate to Build > Applications.

  3. Click the Add new link, enter a descriptive name for the application (for example, "Nexla Integration"), and choose Integration API as the API type.

  4. After the application is created, the Console displays the application's Client ID and Client Secret. Copy both values immediately.

    • The Client ID can be considered public information and remains visible in the Console.

    • The Client Secret is shown only once, at the time the application is created. If you lose it, you must create a new application to obtain a new secret.

  5. Store both credentials securely, as you will need them to configure your Nexla credential. Never expose the Client Secret to untrusted devices or applications, as it grants full read and write access to your marketplace data.

For detailed information about the Integration API, authentication, and available endpoints, see the Sharetribe Integration API documentation and the Integration API reference.

Authenticate

Credentials required

FieldRequiredSecretDescription
Client IDYesNoA unique public identifier assigned to your application
Client SecretYesYesA confidential password provided alongside the client ID

Create a credential in Nexla

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter the Client ID for your Sharetribe Integration API application in the corresponding field. This is the public identifier obtained from your Sharetribe Console in Prerequisites.

  4. Enter the Client Secret for your Sharetribe Integration API application in the corresponding field. This is the confidential secret shown at application creation and must be kept confidential.

    If your Client Secret is compromised, create a new Integration API application in the Sharetribe Console to obtain a fresh Client ID and Client Secret, then update your Nexla credential. The Client Secret grants full access to your marketplace data and should be treated as sensitive information.

    For detailed information about Integration API authentication and application management, see the Sharetribe Applications documentation.

  5. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Sharetribe connector tile, then select the credential that will be used to connect to the Sharetribe instance, and click Next; or, create a new Sharetribe credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Sharetribe endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

[Rest API] List Users

Retrieve users.

  • This endpoint template queries the marketplace users from your Sharetribe Integration API. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of user records.

For detailed information about the users resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Transactions

Retrieve transactions.

  • This endpoint template queries the transactions on your marketplace. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of transaction records.

For detailed information about the transactions resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] Get Transaction

Fetch a single transaction by ID.

  • This endpoint template retrieves one transaction. Provide the Transaction Id for the transaction you want to fetch when configuring the endpoint.

For detailed information about the transactions resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Marketplace

Retrieve marketplace.

  • This endpoint template retrieves information about your marketplace, such as its name and settings.

For detailed information about the marketplace resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Listings

Retrieve listings.

  • This endpoint template queries the listings on your marketplace. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of listing records.

For detailed information about the listings resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Events

Retrieve events.

  • This endpoint template queries the events on your marketplace, which record changes to marketplace resources. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of event records.

For detailed information about the events resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Messages

Retrieve messages.

  • This endpoint template queries the messages exchanged between marketplace users. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of message records.

For detailed information about the messages resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Bookings

Retrieve bookings.

  • This endpoint template queries the bookings on your marketplace. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of booking records.

For detailed information about the bookings resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] List Reviews

Retrieve reviews.

  • This endpoint template queries the reviews on your marketplace. Results are paginated, and Nexla automatically iterates through the available pages to ingest the full set of review records.

For detailed information about the reviews resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] Get User

Retrieve a single marketplace user by ID or email.

  • This endpoint template retrieves one user. Provide the User Id for the user you want to fetch when configuring the endpoint.

For detailed information about the users resource and its response structure, see the Sharetribe Integration API reference.

[Rest API] Get Listing

Retrieve a specific marketplace listing by ID.

  • This endpoint template retrieves one listing. Provide the Listing Id for the listing you want to fetch when configuring the endpoint.

For detailed information about the listings resource and its response structure, see the Sharetribe Integration API reference.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Sharetribe data sources can also be manually configured to ingest data from any valid Sharetribe Integration API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Sharetribe data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Sharetribe destination, and select the Send to Destination option from the menu. Select the Sharetribe connector from the list of available destination connectors, then select the credential that will be used to connect to the Sharetribe marketplace, and click Next; or, create a new Sharetribe credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Sharetribe endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

[Rest API] Create Listing

Publish a new marketplace listing immediately.

  • This endpoint sends each record from your Nexset as a JSON request body to create and publish a new listing on your marketplace. Ensure the record structure matches the fields expected by the Sharetribe API.

For detailed information about creating listings and the expected request body, see the Sharetribe Marketplace API reference.

[Rest API] Update Listing

Modify an existing marketplace listing.

  • This endpoint sends each record from your Nexset as a JSON request body to update an existing listing on your marketplace. Ensure the record includes the listing identifier and the fields you want to modify.

For detailed information about updating listings and the expected request body, see the Sharetribe Marketplace API reference.

[Rest API] Create User

Create a new marketplace user account.

  • This endpoint sends each record from your Nexset as a JSON request body to create a new user account on your marketplace. Ensure the record includes the fields required by the Sharetribe API for user creation.

For detailed information about creating users and the expected request body, see the Sharetribe Marketplace API reference.

[Rest API] Initiate Transaction

Begin a new transaction process between a buyer and a listing.

  • This endpoint sends each record from your Nexset as a JSON request body to initiate a new transaction between a buyer and a listing. Ensure the record includes the transaction process, listing, and any parameters required by the Sharetribe API.

For detailed information about initiating transactions and the expected request body, see the Sharetribe Marketplace API reference.

[Rest API] Send Message

Send a message between marketplace users.

  • This endpoint sends each record from your Nexset as a JSON request body to post a message within a transaction between marketplace users. Ensure the record includes the transaction identifier and message content required by the Sharetribe API.

For detailed information about sending messages and the expected request body, see the Sharetribe Marketplace API reference.

[Rest API] Approve User

Transition a pending user to the active state.

  • This endpoint sends each record from your Nexset as a JSON request body to approve a pending user, moving them to the active state on your marketplace. Ensure the record includes the user identifier required by the Sharetribe API.

For detailed information about approving users, see the Sharetribe Integration API reference.

[Rest API] Close Listing

Close an active marketplace listing.

  • This endpoint sends each record from your Nexset as a JSON request body to close an active listing on your marketplace. Ensure the record includes the listing identifier required by the Sharetribe API.

For detailed information about closing listings, see the Sharetribe Integration API reference.

Manual configuration

Sharetribe destinations can also be manually configured to send data to any valid Sharetribe API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Sharetribe endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Sharetribe endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.