Skip to main content
POST
/
retailers
/
api
/
v1
/
organizations
/
{organization_id}
/
offers
Create offer
curl --request POST \
  --url https://www.closient.com/retailers/api/v1/organizations/{organization_id}/offers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "retailer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sku": "",
  "url": "",
  "price": 123,
  "price_currency": "USD",
  "source": "manual"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "retailer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sku": "",
  "url": "",
  "price": "<string>",
  "price_currency": "USD",
  "status": "active",
  "is_verified": false,
  "source": "manual",
  "quantity_on_hand": 123
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
organization_id
string<uuid>
required

UUID of the organization to create the offer for.

Body

application/json
​
product_id
string<uuid>
required
​
retailer_id
string<uuid>
required
​
sku
string
default:""
​
url
string
default:""
​
price
​
price_currency
string
default:USD
​
source
string
default:manual

Response

OK

​
id
string<uuid>
required

Unique offer identifier.

​
product_id
string<uuid>
required

Product (product) this offer is for.

​
retailer_id
string<uuid>
required

Retailer selling this product.

​
organization_id
string<uuid>
required

Organization that owns this offer.

​
sku
string
default:""

Retailer-specific SKU.

​
url
string
default:""

URL to the product page on the retailer's site.

​
price
string | null

Product price.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
price_currency
string
default:USD

ISO 4217 currency code.

​
status
string
default:active

Offer status: 'active' or 'inactive'.

​
is_verified
boolean
default:false

Whether the offer has been verified.

​
source
string
default:manual

Data source: 'manual', 'feed', or 'scraper'.

​
quantity_on_hand
integer | null

Current inventory quantity, if known.