"}. Omit it to create a free offer (TYPEFREEOFFER). An unknown parent, invalid parent type, or parent "> "}. Omit it to create a free offer (TYPEFREEOFFER). An unknown parent, invalid parent type, or parent "> "}. Omit it to create a free offer (TYPEFREEOFFER). An unknown parent, invalid parent type, or parent ">

For AI agents: markdown of this page — /docs-content-en/entities/catalog-offers/create.md documentation index — /llms.txt

Create an offer

POST /v1/catalog-offers

Provide name and the offer catalog's iblockId. To link a parent SKU, pass parentId: {"value":"<ID>"}. Omit it to create a free offer (TYPE_FREE_OFFER). An unknown parent, invalid parent type, or parent from another catalog returns Bitrix24's 422 response. Bitrix24 sets type.

Example

Terminal

curl -X POST "https://vibecode.bitrix24.com/v1/catalog-offers" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "VIBE-PROBE example offer", "iblockId": 27, "parentId": {"value": "42"}}'

All offer operations.