Skip to main content
POST
Batch create/upsert vendors

Authorizations

Authorization
string
header
required

Workspace-scoped API key (mk_live_...). Each operation lists the scope it requires in x-required-scopes. See the Authentication guide for the full scope table and key management.

Body

application/json
items
object[]
required
Required array length: 1 - 100 elements
merge_key
string

Optional shared merge key — when present, items upsert instead of create.

Response

Per-item results, in input order, under a summary that makes "N of M failed" a single field read. Check every item — a 200 only means the batch was processed. Route retries on error.retriable, never on message text. Summaries from re-runs must not be summed (an idempotent retry reports updates for rows the first attempt created).

summary
object
required

Batch-level counts. has_errors is the cheap "anything to look at?" check; clean batches can skip the per-item scan. Do not sum summaries across idempotent re-runs of the same batch.

Example:
data
object[]
required