> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.duve.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.duve.com/_mcp/server.

## 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](mailto:partnership@duve.com).

## 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](https://postman.com).
2. Use the following button to fork the collection:
    [![Run in Postman](https://run.pstmn.io/button.svg)](https://elements.getpostman.com/view/import?collection=7066777-11c5b66d-6a5d-4552-9cc8-9[…]be-5603-4010-b8a0-799f5286cbc6-SVtPYBKd&source=documenter)
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](/api-references/open-api/open-api/authorization/token) 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.
:construction: **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](mailto:support@duve.com).

### 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.