Skip to main content
Import endpoints allow you to synchronize your POS product catalog, categories, and promotions with the ClearLine platform. This ensures that marketing campaigns, loyalty programs, and analytics have access to up-to-date product information.

​
What Can You Import?

Products

Product items with pricing, SKUs, categories, and manufacturer details

Categories

Product category hierarchies and catalog organization

Promotions

Active promotions and special offers from your POS system

​
Why Import Data?

Keeping your product catalog synchronized with ClearLine enables:
  • Targeted Marketing: Create promotions based on specific products, categories, or price ranges
  • Accurate Analytics: Track product performance and sales trends with up-to-date data
  • Dynamic Loyalty: Configure rewards based on product purchases and categories
  • Smart Promotions: Display relevant offers based on purchased items

​
Import Strategies

Send your entire product catalog in a single import. Best for: Initial setup, major catalog changes, scheduled daily/weekly jobs

​
Import Endpoints

Import Products

Sync product catalog with SKUs, prices, categories, and manufacturers

Import Product Categories

Sync category hierarchies and catalog organization structure

Import Promotions

Sync active promotions and special offers from your POS

Authentication

Learn how to authenticate for import operations

​
Best Practices

Schedule Regular Syncs

  • Daily full sync for most retailers (recommended during off-peak hours)
  • Hourly incremental for high-volume or frequently changing catalogs - Real-time updates for critical changes like new products or price updates
  • Ensure required fields are present and not empty - Verify prices are valid positive numbers - Check that category references exist - Confirm product IDs are unique
  • Log all import responses (successes and failures) - Retry failed imports with exponential backoff - Don’t stop entire sync for individual item errors
  • Alert your team for persistent failures
  • Use the same product IDs across all imports - Import categories before products that reference them - Include all active items in full syncs - Don’t delete and re-create items unnecessarily

​
Next Steps

Start with Product Import

View complete API specification and request examples

Complete Integration Guide

Step-by-step guide with implementation details