Product Submissions API Overview

The Product Submissions API is used for adding products to the Zalando Catalog. Use the Product Submissions API to submit a product submission JSON file to the zDirect API.

Product Submissions API Scopes

To use the Product Submissions API, your client must have the Products/products/write scope.

Many zDirect APIs require clients to have specific permissions or scopes for read or write access. You may assign scopes to your apps in the "Applications" section of the zDirect Portal.

For more information on configuring app scopes, see the Applications section of our zDirect Portal guide.

Rate Limiting

Each app may only make the following number of requests per second:

Environment req/sec
production 25
sandbox 25

For more information, see Rate Limiting.

Sandbox Behavior

When you submit a product submission JSON using the Product Submissions API in the sandbox environment, the JSON will be subjected to the same automated validation as in the production environment.

This validation checks that the submission is a valid JSON (that is, no missing or illegal characters), and that all required attribute types are defined.

If you receive an http 200 code when submitting a JSON to the sandbox, you may be confident that the basic structure and content is correct.

During actual submission in the product environment, additional rounds of manual and automated validation are applied to verify that your attribute definitions are not just valid, but correct, as-intended, and so forth. We cannot provide that level of validation in the sandbox environment, unfortunately.

Product submissions made in the sandbox environment are never persisted or propagated. You will not, for example, be able to view sandbox submissions in your Product Status Report.

For more information, see Sandbox Testing in our Getting Started Guide.

Additional Resources

Contact Support