# Create a new offer

configures automated price adjustments for an offerconfigures automated price adjustments for an offerconfigures automated price adjustments for an offeThe following API allow you to create a new offer/auction on Driffle.

<mark style="color:green;">`POST`</mark> `/offer`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Response**

### Required arguments

| Param       | Param Type | Type                  | Required                                         | Description                                                              |
| ----------- | ---------- | --------------------- | ------------------------------------------------ | ------------------------------------------------------------------------ |
| product     | body       | { productId: number } | Yes                                              | ProductId for which offer needs to be created                            |
| yourPrice   | body       | Number                | No (Either yourPrice or retailPrice is required) | Selling price. Commission will be applied to this price.                 |
| retailPrice | body       | Number                | No (Either yourPrice or retailPrice is required) | Retail Price or Buy Box Price. Commission is subtracted from this price. |

### Optional arguments

#### **Case - Declared Stock**&#x20;

{% hint style="warning" %}

1. Either keys or declaredStock number should be provided in the request.
2. Either yourPrice or retailPrice should be provided in the request.
   {% endhint %}

| Param                | Param Type | Type                                                                                                                                  | Required                                         | Description                                                                                                                                                                        |
| -------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| product              | body       | { productId: number }                                                                                                                 | Yes                                              | ProductId for which offer needs to be created                                                                                                                                      |
| yourPrice            | body       | Number                                                                                                                                | No (Either yourPrice or retailPrice is required) | Selling price. Commission will be applied to this price.                                                                                                                           |
| retailPrice          | body       | Number                                                                                                                                | No (Either yourPrice or retailPrice is required) | Retail Price or Buy Box Price. Commission is subtracted from this price.                                                                                                           |
| cogs                 | body       | Number                                                                                                                                | No                                               | Cost of purchasing a single key                                                                                                                                                    |
| keys                 | body       | array\<KeyUploadType>, see [#keyuploadtype](#keyuploadtype "mention")                                                                 | No                                               | List of Keys to be uploaded - optional                                                                                                                                             |
| declaredStock        | body       | Number                                                                                                                                | No                                               | Number of keys to sell through declared stock feature -  optional                                                                                                                  |
| wholesale            | body       | `{"enabled":true,"tiers":[{"level":1,"discount":10},{"level":2,"discount":15}]}`                                                      | No                                               | <p>Specifies wholesale enable status and tier-based discounts by purchase quantity.  </p><p><a data-mention href="/pages/CHpnEoAKrUwG83s8QSGk">/pages/CHpnEoAKrUwG83s8QSGk</a></p> |
| automatePriceOptions | body       | `{"lowerPriceLimit":8.99,"upperPriceLimit":12.99,"priceChangeFactor":0.05,"priceChangeInterval":3600,"automatePriceStatus":"enable"}` | No                                               | configures automated price adjustments for an offer [Automate Pricing](/driffle-seller-api-legacy/reference/automate-pricing.md)                                                   |

#### **Case - Direct Topup webhook**

| Param                | Param Type | Type                                                                                                                                  | Required                                         | Description                                                                                                                      |
| -------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| product              | body       | { productId: number }                                                                                                                 | Yes                                              | ProductId for which offer needs to be created                                                                                    |
| yourPrice            | body       | Number                                                                                                                                | No (Either yourPrice or retailPrice is required) | Selling price. Commission will be applied to this price.                                                                         |
| retailPrice          | body       | Number                                                                                                                                | No (Either yourPrice or retailPrice is required) | Retail Price or Buy Box Price. Commission is subtracted from this price.                                                         |
| cogs                 | body       | Number                                                                                                                                | No                                               | Cost of purchasing a single key                                                                                                  |
| declaredStock        | body       | Number                                                                                                                                | Yes                                              | Number of direct topup allowed for sell                                                                                          |
| automatePriceOptions | body       | `{"lowerPriceLimit":8.99,"upperPriceLimit":12.99,"priceChangeFactor":0.05,"priceChangeInterval":3600,"automatePriceStatus":"enable"}` | No                                               | configures automated price adjustments for an offer [Automate Pricing](/driffle-seller-api-legacy/reference/automate-pricing.md) |

#### **Case - Pre-Order Product**

{% hint style="warning" %} <mark style="color:green;">**Declared stock is now available for pre-order products.**</mark>

For more details, see the [Pre-Order-Declare-Stock](/driffle-seller-api-legacy/reference/pre-order-declare-stock.md) documentation.
{% endhint %}

<table><thead><tr><th>Param</th><th>Param Type</th><th width="200">Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td>product</td><td>body</td><td>{ productId: number }</td><td>Yes</td><td>ProductId for which offer needs to be created</td></tr><tr><td>yourPrice</td><td>body</td><td>Number</td><td>No (Either yourPrice or retailPrice is required)</td><td>Selling price. Commission will be applied to this price.</td></tr><tr><td>retailPrice</td><td>body</td><td>Number</td><td>No (Either yourPrice or retailPrice is required)</td><td>Retail Price or Buy Box Price. Commission is subtracted from this price.</td></tr><tr><td>cogs</td><td>body</td><td>Number</td><td>No</td><td>Cost of purchasing a single key</td></tr><tr><td>keys</td><td>body</td><td>array&#x3C;KeyUploadType>, see <a data-mention href="#keyuploadtype">#keyuploadtype</a></td><td>No</td><td>List of Keys to be uploaded - optional</td></tr><tr><td>auctionedKeys</td><td>body</td><td>Number</td><td>Yes</td><td>Maximum number of orders you can accept for a product (Only in preReleased products)</td></tr></tbody></table>

#### KeyUploadType&#x20;

| Param | Type   | Required                  | Description                                                                                                                                      |
| ----- | ------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| key   | string | Yes                       | Key in plain text or In case of image keys, Send a base64 encoded string. For more info Read [RFC 2397](https://www.rfc-editor.org/rfc/rfc2397). |
| name  | string | Yes, in case of image key | Name of key                                                                                                                                      |
| type  | string | Yes                       | Key format. supported values: `text`, `image`                                                                                                    |

{% tabs %}
{% tab title="200" %}

```json
{
  "message": "string",
  "statusCode": 200,
  "offer": {
    "offerId": 0,
    "productId": 0,
    "yourPrice": 0,
    "finalSellingPrice": 0,
    "availableStock": 0
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "message": "Bad Request. Wrong/Invalid params format.",
    "statusCode": 400 
}
```

{% endtab %}

{% tab title="401" %}

```
{
    "message": "UnAuthorized request. Invalid/Expired token",
    "statusCode": 401
}
```

{% endtab %}

{% tab title="403" %}

```
{
    "message": "Forbidden Request. Action not allowed or Rate Limit exhausted.", 
    "statusCode": 403
}
```

{% endtab %}

{% tab title="500" %}

```
{
    "message": "Internal Server Error",
    "statusCode": 500
}
```

{% endtab %}
{% endtabs %}

{% openapi src="/files/tEroTEtPC9evUumXzEL2" path="/offer" method="post" %}
[swagger-3.1.3.json](https://407468006-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfPzmNpsOZnU4ujov7zQD%2Fuploads%2FGJM0JzGLlFvZCh6JCSti%2Fswagger-3.1.3.json?alt=media\&token=bdd6043d-7f7a-4bde-a491-fade2a449f6a)
{% endopenapi %}


---

# 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://docs.driffle.com/driffle-seller-api-legacy/reference/api-reference/offers-auction/create-a-new-offer.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.