List Mappable Product Fields
GET/api/v2/listing-drafts/mappable-product-fields
Product columns usable as a product_field mapping source in draft field_overrides and template field defaults. Served from the resolver whitelist (ListingValueResolver) so pickers never offer a column the resolver won't read.
brand resolves through the product's brand relation (ProductBrand::name); price resolves through the default pricing tier accessor; all other values are direct product columns.
Authentication: Requires Bearer token.
Feature flag: requires listing-publishing to be enabled.
Each item includes type — the column's data type (text or number) — so the mapping picker can show what kind of value a column carries.
Request
Responses
- 200
- 401
- 403
- 429
OK
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.