Skip to main content
Carries an idempotency key. Retried on network failure, timeout, 429, and 409 idempotency.in_progress - never on a 5xx.

Example

Parameters

string
required
Human-readable collection name.
string
Short collection symbol (max 4 chars). Derived from name when omitted.
string
Your own mapping to this collection (SKU / concept id).
integer
Identifier of the network to create the collection on. Defaults to your organization’s configured network; send a value only to override it where enabled for your organization.
string | null
Tap redirect URL for this collection’s units. Omit or null for none; unit- and product-level redirects still take precedence.

Returns

201 - Collection.
string
required
object
required
string | null
required
string | null
required
string | null
required
URL a tap on this collection’s units redirects to. Unit- and product-level redirects take precedence over this value.

Errors

Branch on error.code, never on the HTTP status - several codes share one. See Errors and retries for the error types and how to narrow them.