Contracts, collections, and events — not guesswork.
Build on CataZenta with OpenAPI specs, a ready-to-run Postman collection, and clear paths for automation — while official JavaScript and Python SDKs are on the way.
Base URL: https://api.catazenta.com. For Claude, ChatGPT, and Cursor, prefer MCP — tools mirror REST with schema discovery built in.
Developer tools at a glance
| Tool | Status | Best for |
|---|---|---|
| Postman collection | Available | Explore APIs, share requests with your team |
| OpenAPI specs | Available | Codegen, contract tests, Redoc on this site |
| Webhooks | Job polling today | Export/import job monitoring; outbound events on roadmap |
| Service account recipe | Available | CI/CD and integration users without personal passwords |
| JavaScript SDK | Coming soon | TypeScript apps and Node workers |
| Python SDK | Coming soon | Scripts, data pipelines, backend services |
| CLI | Planned | Local dev and CI (catazenta export run …) |
When to use what
| Goal | Start here |
|---|---|
| Learn the API in 5 minutes | First API call · Postman |
| Generate a typed client | OpenAPI downloads — use Orval, openapi-fetch, or your generator |
| Nightly ERP sync or CI publish | Service account · Recipes |
| Monitor export jobs | Poll export job · Webhooks |
| Claude / Cursor automation | MCP quickstart — prefer MCP over hand-rolled SDK calls |
| In-product agent runs | Agentic PIM — not a substitute for your integration code |
Postman collection
Import the CataZenta collection for interactive requests against https://api.catazenta.com.
Recommended flow
- Run Login → save
access_tokento environment - Set
X-Tenant-Idon folder defaults - Explore Product → Integration → Job folders
- Pair with AI workflow examples for real-world sequences
→ Postman guide · Download on API tools
OpenAPI contract
Each API domain ships an OpenAPI 2.0 specification — rendered as interactive Redoc on this site and downloadable as JSON.
| Domain | Reference |
|---|---|
| Products | Product API |
| Categories | Category API |
| Attributes | Attribute API |
| DAM | DAM API |
| IAM | IAM API |
| Integration | Integration API |
| Jobs | Job API |
| Search | Search API |
Full index → Core Commerce APIs · API reference
Until official SDKs ship, generate clients from OpenAPI or call REST directly with authentication.
Webhooks & job events
Most integrations today poll export and import jobs for completion and per-SKU results. Outbound webhooks for job completion and catalog events are on the roadmap.
| Today | Roadmap |
|---|---|
Poll GET /v1/jobs/{id} and job items | Push notifications on job completion |
| Poll export job recipe | Catalog event subscriptions |
→ Webhooks reference · SDK webhooks page
Official SDKs (coming soon)
JavaScript / TypeScript
Coming soon. Until release: OpenAPI codegen, fetch, or MCP.
Python
Coming soon. Until release: REST with service accounts and recipes.
CLI
Planned — catazenta auth login, export run, jobs watch.
Want early SDK access? Contact CataZenta.
Service accounts for automation
Run integrations without a personal user password — least-privilege integration users for CI and workers.
- Admin → Users → create integration user
- Assign role (products, integration run — as needed)
- Authenticate via
POST /v1/auth/login - Store token in your secret manager; rotate on schedule
→ Service account recipe · Security
For local MCP: set CATAZENTA_USERNAME / CATAZENTA_PASSWORD in connector env — see MCP authentication.
Get started
- Complete Your first API call.
- Import the Postman collection and set tenant variables.
- Download OpenAPI from API tools if you need codegen.
- Pick a recipe for your integration scenario.
- Use MCP when building with Claude, ChatGPT, or Cursor.
- Create a service account before production CI.
GO DEEPER