Revclic
API Reference
POST /product-offers

Create a product offer

Product Offers

Description

Create a new product offer for a merchant.

Authentication Required: User must be authenticated and have the 'merchant' feature flag.

Authorization: Merchant users can only create offers for their own merchant account.

Request Body

required

application/json

merchant_idintegerrequired
Merchant ID to associate the offer with
Example: 1
product_idintegerrequired
Associated product ID
Example: 123
skustringrequired
Stock Keeping Unit
Example: PROD-12345
pricenumber (float)required
Current price (must be >= 0)
Example: 29.99
former_pricenumber (float)
Previous price for discount display
Example: 39.99
urlstring (uri)required
URL to the product page
Example: https://myshop.com/product/12345
delivery_costsobject
Delivery costs by shipping method
Example: {"standard":4.99,"express":9.99}
delivery_timeintegerrequired
Estimated delivery time in days
Example: 3
order_processing_timeinteger
Order processing time in days
Example: 1
free_return_daysinteger
Number of days for free returns
Example: 30
usedbooleanrequired
Whether the product is used
conditionstringenum: new, like_new, good, fair, poor
Product condition
Example: new
commission_ratenumber (float)
Commission rate percentage (0-100)
Example: 5.0

Responses

201 Offer created successfully
application/json
statusstring
Example: success
messagestring
Example: Offer created successfully
dataobject
401 Authentication required
application/json
Example:
{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}
404 Merchant not found
application/json
Example:
{
  "status": "error",
  "message": "Merchant not found"
}
422 Validation error
application/json
Example:
{
  "status": "error",
  "message": "Failed to create offer",
  "errors": [
    "Sku can't be blank",
    "Price can't be blank"
  ]
}