Skip to content

About supplier_id

Supplier ids are partner-supplied and must match [A-Za-z0-9._\-]{1,255} so they round-trip safely through URL path segments. Up to v1.6.x this field was called external_id (see the v1.7.0 entry in the changelog).

About custom_fields

Read responses (GET /suppliers, GET /suppliers/{supplier_id}) return custom_fields keyed by the field's display label — the same label you see in the Mercura admin UI — rather than the internal column id. Columns with no active definition are omitted, and on a label collision the column defined first (by display order, then creation time) wins. On the write path (POST /suppliers) send custom_fields keyed by the internal column id; only reads are label-keyed.