Skip to main content

How to export products to a channel

Syndication pushes approved catalog data to a commerce destination. This tutorial walks the API flow; merchandisers can also export from the UI — Syndication guide.

Prerequisites​

Overview​

Step 1 — List available connectors​

curl -s "https://api.catazenta.com/v1/connectors" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Tenant-Id: ${TENANT}"

Pick the platform (e.g. Amazon, Shopify). Connector-specific setup: Integrations hub.

Step 2 — Create a connection​

Store credentials and marketplace context (for Amazon: marketplace_id, seller account).

Exact body fields are in the Integration API. Example pattern:

curl -s -X POST "https://api.catazenta.com/v1/connections" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Tenant-Id: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "connector_id": "CONNECTOR_UUID",
    "name": "Amazon US Production",
    "config": {}
  }'

Step 3 — Create an export profile​

An export profile links:

  • Connection
  • Channel (PIM channel — locales and completeness)
  • Schema / feed format
  • Product selection (IDs, family, or filter)

See Integration API for export_profiles endpoints.

Step 4 — Map attributes​

Map PIM attribute codes → channel fields. For Amazon, mappings may vary by category (browse node).

PIM sourceChannel target
title (locale)Listing title
bullet_1 …Bullet points
main_imagePrimary image URL

Validate mappings on 1–2 pilot SKUs before bulk export.

Step 5 — Start an export job​

curl -s -X POST "https://api.catazenta.com/v1/export-jobs" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Tenant-Id: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "export_profile_id": "PROFILE_UUID",
    "product_ids": ["PRODUCT_UUID"]
  }'

Save the returned job id.

Step 6 — Poll job status​

curl -s "https://api.catazenta.com/v1/jobs/JOB_UUID" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "X-Tenant-Id: ${TENANT}"

Inspect per-SKU rows for errors (missing attribute, auth, mapping). Full pattern: Poll export job.

Channel-specific recipes​

ChannelRecipe
AmazonAmazon syndication
ShopifyShopify syndication

AI-assisted publish​

For completeness-gated bulk publish, see Publish complete products.

Next steps​