Postman guide

Duve Connect API Documentation

Explore and test Duve’s OpenAPI using Postman. To send requests and view responses, ensure you have an active Duve account. Note for Partners & Channels (OTAs) If you are a Duve Marketplace or Channel (OTA) Partner, please refrain from using the Open API and contact our partnerships team.

Getting Started with Duve’s Postman Collection

You can quickly test APIs by forking Duve’s Postman collection. Follow these steps:

1. Fork the Duve OpenAPI Postman Collection

  1. Sign up or log in to an account on postman.com.
  2. Use the following button to fork the collection: Run in Postman
  3. Select Fork Collection.
  4. Name your fork and select a workspace.

2. Generate an Authentication Token

To authenticate, follow our authentication guide for Postman to generate an access token using the keys you saved when creating your OAuth application. Make sure to read our guide to understand how to correctly manage your access. 🚧 Permission Error If you see a “You don’t have permission to access, please contact Duve support” error, ensure the authorization header includes Bearer before the token (e.g., Bearer {token}). If the issue persists, contact support.

3. Make API Calls with Postman

The following examples use the Listings API to create and update listings on your Duve account.

Create a Listing

To create a listing:

  1. In your Postman workspace, navigate to your fork of the Duve OpenAPI collection.
  2. Select Listings > Create a listing.
  3. In the Body tab, enter values to configure and describe the listing.
  4. Select Send. A successful call will return an HTTP 201 OK response code.

Update a Listing

Edit listing fields as follows:

  1. Find the _id in the response of the listing you created and copy the value.
  2. Navigate to your fork of the Duve OpenAPI collection.
  3. In the Variables tab, paste the _id in the id field.
  4. Select Listings > {id} > Update a listing.
  5. In the Body tab, enter the relevant body parameter values and discard any unnecessary ones.
  6. Select Send. A successful call will return an HTTP 201 OK response code.
Built with