How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Mapp Product Catalog Public API

The Product Catalog Public API manages product and variant data inside Mapp Cloud catalogs — create, replace, partially update, upsert, bulk-load and delete variants, manage variant attributes, read catalog and attribute metadata for a workspace, and list variants for a product. Bearer-JWT (Keycloak) authentication against https://api.mapp.com/api/product-catalog/v1.

Mapp Product Catalog Public API is one of 4 APIs that Mapp Marketing Cloud publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include E-Commerce, Product Catalog, and Data Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

This API exposes 15 operations across 8 paths, organized into 4 resource areas, and defines 18 schemas. It is described by OpenAPI 3.0.1, at version 1.0.1.

Requests are made against a single base URL, https://api.mapp.com.

15 operations 8 paths 18 schemas 4 DELETE5 GET2 PATCH2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0.1
Base URL
https://api.mapp.com
Authentication
HTTP Bearer
Resource Areas
4

Authentication & Security 1

Mapp Product Catalog Public API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (Keycloak). By default, every request must be authenticated.

Paths & Operations 15

Across 8 paths, the API surfaces 15 operations — 4 DELETE, 5 GET, 2 PATCH, 2 POST, 2 PUT. They span 4 resource areas: Variant Data Operations, Variant Data Bulk Operations, Catalog Metadata Operations, Product Data Operations. Each is listed below with its method, path, parameters, and response codes.

Variant Data Operations 8

Endpoints for variant data operations

POST
/api/product-catalog/v1/catalogs/{catalogId}/variants
Add a new variant or add missing data to an existing variant.
addVariant 1 param body → 400202500
GET
/api/product-catalog/v1/catalogs/{catalogId}/variants
List variants with cursor pagination
getPaginatedVariants 8 params → 200400404204500
PUT
/api/product-catalog/v1/catalogs/{catalogId}/variants/{variantId}
Create or fully replace a variant
upsertVariant 2 params body → 500400202
DELETE
/api/product-catalog/v1/catalogs/{catalogId}/variants/{variantId}
Delete a variant by ID
deleteVariant 2 params → 202400404500
GET
/api/product-catalog/v1/catalogs/{catalogId}/variants/{variantId}
Get a single variant by ID
getVariant 4 params → 500404200204400
PATCH
/api/product-catalog/v1/catalogs/{catalogId}/variants/{variantId}
Partially update a variant
partialUpdateVariant 2 params body → 400202500
DELETE
/api/product-catalog/v1/catalogs/{catalogId}/variants/
Delete all variants in a catalog
deleteAllCatalogData 1 param → 500202400
DELETE
/api/product-catalog/v1/catalogs/{catalogId}/variants/{variantId}/attributes
Delete attributes from a variant
deleteVariantAttributes 2 params body → 404500202400
Variant Data Bulk Operations 4

Endpoints for variant data bulk operations

POST
/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk
Bulk add variants
bulkAddVariants 1 param body → 202500400422
DELETE
/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk
Bulk delete variants
bulkDeleteVariants 1 param body → 400422500202
PATCH
/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk
Bulk partial update variants
bulkPartialUpdateVariants 1 param body → 202500422400
PUT
/api/product-catalog/v1/catalogs/{catalogId}/variants/bulk
Bulk upsert variants
bulkUpsertVariants 1 param body → 400202422500
Catalog Metadata Operations 2

Endpoints for catalog metadata operations

GET
/api/product-catalog/v1/catalogs/metadata/attribute/{catalogId}
Get all attributes assigned to a catalog
getCatalogAttributes 1 param → 200500204
GET
/api/product-catalog/v1/catalogs/metadata/catalog/workspace
Get catalog metadata for a workspace
getCatalogMetadataByWorkspace → 204404200500
Product Data Operations 1

Endpoints for product data operations

GET
/api/product-catalog/v1/catalogs/{catalogId}/products/{productId}/variants
List variants of a product
listVariants 9 params → 400204404200500

Schemas 18

The contract defines 18 schemas that model the data the API accepts and returns. The most detailed are VariantFlatViewResponse (39 properties), AddVariantOperationFlatSchema (34 properties), BulkPartialUpdateVariantOperationFlatSchema (34 properties), BulkUpsertVariantOperationFlatSchema (34 properties). Each schema is shown below with its type and property counts.

AddVariantOperationFlatSchema
object
Flat request payload for adding a SOURCE variant, where: - predefined SOURCE attributes are documented as fields here. - custom SOURCE attributes are added dyn…
34 properties 1 required
VariantOperationResponseDTO
object
9 properties
ErrorResponse
object
4 properties
SkippedAttributesDTO
object
3 properties
BulkVariantOperationResponseDTO
object
10 properties
VariantEventResult
object
6 properties
BulkDeleteVariantOperationFlatSchema
object
Flat request payload for bulk deleting a SOURCE variant.
1 property 1 required
BulkPartialUpdateVariantOperationFlatSchema
object
Flat request payload for bulk partially updating a SOURCE variant, where: - predefined SOURCE attributes are documented as fields here. - custom SOURCE attribu…
34 properties 1 required
BulkUpsertVariantOperationFlatSchema
object
Flat request payload for bulk creating or fully replacing a SOURCE variant, where: - predefined SOURCE attributes are documented as fields here. - custom SOURC…
34 properties 1 required
UpsertVariantOperationFlatSchema
object
Flat request payload for creating or fully replacing a SOURCE variant, where: - predefined SOURCE attributes are documented as fields here. - custom SOURCE att…
33 properties
CatalogOperationResponseDTO
object
6 properties
VariantFlatViewResponse
object
Flat variant payload based on the unified product catalog schema, where: - predefined SOURCE attributes are documented as fields here. - custom SOURCE attribut…
39 properties 5 required
CatalogAttributeDTO
object
Represents a single product catalog attribute with its data type and optional localization metadata
5 properties
CatalogDTO
object
Public catalog metadata
7 properties
ProductVariantsResponseDTO
object
6 properties
PaginationCursorDTO
object
Only set when pagination is used
4 properties
PaginatedVariantsResponseDTO
object
2 properties
PartialUpdateVariantOperationFlatSchema
object
Flat request payload for partially updating a SOURCE variant, where: - predefined SOURCE attributes are documented as fields here. - custom SOURCE attributes a…
33 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mapp-product-catalog-openapi.yml Raw ↑

Other APIs Mapp Marketing Cloud publishes across the network.

Mapp Engage API
Mapp Intelligence Analytics API
Mapp Fashion API
Where this information came from

This is an independent, third-party profile of Mapp Product Catalog Public API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.