Inventory Items API Endpoints¶
About Inventory Items¶
Inventory Item - An Inventory Item directly represents a specific ad and acts as a container for 1 or more creatives. Inventory Items can be posted manually (creatives and via templates) or can map to third party items such as Products, Vehicles, Properties, etc.
| Property | Value |
|---|---|
| Can Create | Yes |
| Can Delete | Yes |
Key Features¶
- Container for one or more creatives
- Represents a specific ad
- Belongs to Account objects
- Can be created manually or via data sources
- Maps to third-party items (products, vehicles, properties)
Vendor ID Mapping¶
Use the unique_id field to map to your internal inventory:
- eCommerce: Product ID or SKU
- Automotive: VIN or dealer stock number
- Real Estate: MLS numbers
Use Cases¶
- Manual ad posting
- Automated inventory sync via data sources
- Dynamic creative generation via templates
- Product/vehicle/property advertising
- Creative inventory connectivity
Endpoints¶
| Method | Endpoint | Description |
|---|---|---|
POST |
/api/v3/inventory-items | POST /inventory-items |
GET |
/api/v3/inventory-items/constants/creative-states | GET /inventory-items/constants/creative-states |
GET |
/api/v3/inventory-items/constants/field-map | GET /inventory-items/constants/field-map |
GET |
/api/v3/inventory-items/constants/inventory-item-classes | GET /inventory-items/constants/inventory-item-classes |
GET |
/api/v3/inventory-items/constants/inventory-item-statuses | GET /inventory-items/constants/inventory-item-statuses |
GET |
/api/v3/inventory-items/constants/price-modifiers | GET /inventory-items/constants/price-modifiers |
PUT |
/api/v3/inventory-items/{lcuid} | PUT /inventory-items/{lcuid} |
GET |
/api/v3/inventory-items/{lcuid} | GET /inventory-items/{id} |