POST product/set | ExpoPlatform Helpdesk

POST `/api/v2/product/set`

Creates a new product or updates an existing one, and assigns it to the specified event.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

POST /api/v2/product/set

Content-Type: multipart/form-data

Create vs Update

Create: Omit id. event_id, exhibitor_id, name, and categories are required
Update: Pass id. Other fields are optional

How products work in ExpoPlatform

Products are exhibitor-level records — a product must be attached to an exhibitor profile to exist. Products do not automatically appear in events; they must be explicitly assigned via event_id.

The product/set endpoint handles both the product record (name, description, images, categories — shared across all events) and event assignment in a single call. The status parameter is the only event-scoped value.

Cross-entity dependencies

What you need	Where to get it
Exhibitor ID	`GET /api/v2/exhibitor/getList` or `GET /api/v2/exhibitors/{eventId}/list`
Category IDs	`GET /api/v2/categories/get?event_id=`

Body Parameters

Required on create

Parameter	Type	Description
`event_id`	integer	The event to assign the product to
`exhibitor_id`	integer	The exhibitor that owns this product
`name`	string	Product display name
`categories`	string	Comma-separated product category IDs

Optional

Parameter	Type	Description
`id`	integer	When provided, updates the matching product
`description`	string	Product description
`status`	integer	`1` = visible (default), `0` = hidden for this event
`images[]`	file or URL	Product images (`image/png`, `image/jpeg`)
`update_images`	boolean	When `true` on update, deletes existing images before saving new ones
`launch`	boolean	When `true`, marks as a "launch" product

Error Responses

HTTP Code	Condition	Error Message
400	`id` provided but not found	`Could not find an product with id = {id}`
400	Required field missing	`Missing required parameter: {field}`
400	`exhibitor_id` not found	`Could not find an exhibitor with id = {id}`
403	Missing or invalid API key	`Forbidden`

Non-fatal: Invalid category IDs are reported in data.error but do not fail the request.