Skip to main content
POST
Submit a batch of product events

Authorizations

Authorization
string
header
required

Personal Access Token or OAuth 2.1 access token, sent as a bearer credential (Authorization: Bearer inf_pat_...). Read operations require a token with the READ scope; write operations (POST/PATCH/DELETE) require WRITE.

Body

application/json
events
object[]
required
Required array length: 1 - 5000 elements

Response

SUCCESS: every event was accepted. PARTIAL_SUCCESS (batch only): at least one event was accepted and the rejected ones are listed in errors.

Contains only errors and metadata; accepted events are not listed individually. Missing required fields are grouped into one INVALID_SCHEMA error; a null value counts as missing. If none are missing, unknown fields are grouped the same way. Otherwise only the first validation failure is returned. Each failed event produces at most one public error.

meta
object
required
errors
object[]