.png)
Productsup Integration Guide
Productsup integrates with enterprise systems through authenticated REST APIs, feed-oriented file exchange, and selective event or notification capabilities for product-data workflows.
Productsup integration options at a glance
Productsup provides authenticated REST APIs for accessing platform resources and product-data workflows, including projects, sources, channels, imports, exports, and related processing operations where supported by the tenant’s API version. Feed-oriented bulk and asynchronous processing is important for large catalogs, although job and status capabilities should be confirmed for the applicable edition. File and feed exchange can support scheduled imports, exports, and recovery processes through the supported upload, URL, SFTP, or other transfer method. Productsup may provide selective event or notification capabilities, but broad webhook coverage is not confirmed. Martini can authenticate through securely managed environment configuration, orchestrate scheduled or event-driven workflows, transform product attributes, validate data, and coordinate Productsup with surrounding systems.
Common Productsup integration patterns
Common Productsup data objects used in integrations
Authentication and security considerations
Tenant and project permissions
Productsup API authentication and authorization details must be confirmed for the tenant’s current API version and account configuration. Do not reuse a Productsup user login, channel credential, or marketplace credential as an API credential unless Productsup explicitly documents that behavior.
Credential protection
Store Productsup credentials, tokens, and endpoint configuration in Martini secrets or environment configuration rather than workflow source code. Use separate credentials for development, testing, and production and apply the least privilege available for projects, sources, channels, and product-data operations.
Transport and callback security
Use the authentication and transport protections documented by Productsup. If callbacks are enabled, verify the documented authentication or signature mechanism, event identity, duplicate behavior, and replay controls before treating a notification as authoritative.
Operational considerations for Productsup integrations
Rate limits and throughput
Confirm Productsup request quotas, payload limits, concurrent-job limits, and feed-size constraints. Use pagination, bounded batches, throttling, and retry backoff for rate-limit and transient server responses.
Asynchronous processing
Separate submission acceptance from completed product processing. Persist import, export, or job identifiers when available and define polling intervals, pending timeouts, and escalation behavior.
Idempotency and reconciliation
Use stable product keys, deterministic payloads, correlation identifiers, and persisted checkpoints to avoid duplicate submissions. Reconcile source, submitted, accepted, rejected, and unresolved counts rather than relying only on HTTP success.
Schema and media handling
Maintain explicit mappings for product attributes, channel-required fields, currencies, locales, units, image URLs, and landing pages. Confirm whether each implementation uses upload endpoints, reachable URLs, SFTP, or another file-transfer method; do not assume Productsup is a general-purpose binary attachment store.
Testing and change management
Confirm the Productsup API version and deprecation policy, isolate Productsup-specific mappings, and test changes against a non-production project. Monitor channel requirements, taxonomies, required attributes, and validation rules as they evolve.
Why use Martini instead of scripts or point-to-point integrations?
Orchestration beyond a script
Martini provides a workflow layer for coordinating Productsup with PIM, ERP, commerce, marketplace, advertising, database, and operational systems. It can manage scheduled retrieval, batch submission, status polling, callback handling, validation, routing, and reconciliation in one maintainable integration flow.
Reusable transformation and business rules
Martini separates canonical product models from Productsup-specific mappings and channel rules. This makes it easier to normalize currencies, locales, identifiers, availability, media references, and custom attributes without duplicating logic across point-to-point scripts.
Operational reliability
Martini can classify errors, apply controlled retries, persist checkpoints, prevent duplicate processing, and expose or consume APIs where required. These capabilities provide a clearer operational boundary than isolated scripts while retaining flexibility for custom logic when the Productsup API or feed contract requires it.