commercetools

Read and write commercetools products, variants, categories, inventory entries and supply channels, stores, orders and customers through the HTTP API.

Keep a headless commerce catalogue, multi-warehouse stock and order states in step with ERP, PIM and fulfilment systems.

Build a flow with commercetools Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

categories

Create category
Destination
Not retried automatically
Approval before production
Creates a category, optionally under a parent.
categories.create
Get category
Source
One category by ID.
categories.get
List categories
Source
Incremental
Categories in the project, optionally modified after a timestamp.
categories.list
Update category
Destination
Provider duplicate protection
Approval before production
Changes a category's name, slug, description, parent, key, order hint or external ID.
categories.update

channels

Create channel
Destination
Provider duplicate protection
Approval before production
Creates a channel such as an InventorySupply warehouse or a ProductDistribution channel.
channels.create
Get channel
Source
One channel by ID.
channels.get
List channels
Source
Incremental
Channels in the project, optionally modified after a timestamp.
channels.list
Update channel
Destination
Provider duplicate protection
Approval before production
Changes a channel's key, name, description, roles or address.
channels.update

customer groups

List customer groups
Source
Incremental
Customer groups in the project, optionally modified after a timestamp.
customer_groups.list

customers

Create customer
Destination
Provider duplicate protection
Approval before production
Creates a customer with ExternalAuth authentication (no password).
customers.create
Get customer
Source
One customer by ID.
customers.get
List customers
Source
Incremental
Customers in the project, optionally modified after a timestamp.
customers.list
Update customer
Destination
Provider duplicate protection
Approval before production
Changes a customer's email, names, company, IDs, VAT ID, group or adds an address.
customers.update

inventory

Create inventory entry
Destination
Not retried automatically
Approval before production
Tracks stock for a SKU, optionally per supply channel (warehouse).
inventory.create
Get inventory entry
Source
One inventory entry by ID.
inventory.get
List inventory entries
Source
Incremental
Inventory entries in the project, optionally modified after a timestamp.
inventory.list
Update inventory entry
Destination
Provider duplicate protection
Approval before production
Sets the absolute quantity, restock days, expected delivery, supply channel or key.
inventory.update

orders

Get order
Source
One order by ID.
orders.get
List orders
Source
Incremental
Orders in the project, optionally modified after a timestamp.
orders.list
Update order
Destination
Provider duplicate protection
Approval before production
Changes order and shipment states, order numbers, customer email, shipping address, or records a delivery with tracking.
orders.update

product types

List product types
Source
Product types that define variant attributes.
product_types.list

product variants

Add product variant
Destination
Provider duplicate protection
Approval before production
Adds a variant with SKU, prices and attributes to an existing product (staged).
product_variants.create
List product variants
Source
Incremental
Product variants in the project, optionally modified after a timestamp.
product_variants.list
Update product variant
Destination
Provider duplicate protection
Approval before production
Sets a variant's SKU, key, prices or attributes (staged).
product_variants.update

products

Create product
Destination
Not retried automatically
Approval before production
Creates a product with its master variant, prices and attributes.
products.create
Get product
Source
One product by ID.
products.get
List products
Source
Incremental
Products in the project, optionally modified after a timestamp.
products.list
Update product
Destination
Provider duplicate protection
Approval before production
Changes the name, slug, description, key, categories or tax category, and optionally publishes.
products.update

stock adjustments

Adjust stock
Destination
Provider duplicate protection
Approval before production
Adds (positive) or removes (negative) quantity on an inventory entry.
stock_adjustments.create

stores

List stores
Source
Incremental
Stores in the project, optionally modified after a timestamp.
stores.list

tax categories

List tax categories
Source
Incremental
Tax categories in the project, optionally modified after a timestamp.
tax_categories.list

Authentication

API client (client credentials)

Plans and access

All commercetools Composable Commerce projects include the HTTP API. Requests act as the API client; its scopes (view_/manage_ per resource) limit what Nexra can read and write.

Test environment

Use a commercetools trial project or a non-production project.

Rate limits

No fixed request quota is published; commercetools applies fair-use throttling and returns HTTP 429 or 503 under load. Query limit is 500 records per page.

Pagination

limit (max 500) and offset (max 10,000) with total; queries sort by lastModifiedAt.

Provider events

Subscriptions deliver messages and change notifications to queues and event buses. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

Offset paging stops at 10,000 records per query; use the updatedSince filter for incremental syncs of large catalogues.
Product and variant changes are staged; set publish on create or update to make them visible.
Orders are read and updated (states, numbers, addresses, deliveries); creating orders from carts, payments and refunds are not automated, and Cancelled states are excluded.
Customers are created with authenticationMode ExternalAuth so Nexra never handles customer passwords.
commercetools has no purchase orders, suppliers or stock transfers; model warehouses as InventorySupply channels and move stock with inventory adjustments per channel.
Deletes are not automated.

Developer reference

Create the commercetools GmbH credentials described above with the narrowest permissions your flows need.
In Nexra, open Connect, then Connections, then New connection, choose commercetools, enter its settings and credentials, and tick only the write actions you need. Connection guide
Test the connection, then use its actions as flow sources and destinations. Flow guide

commercetools GmbH docsAPI reference commercetools GmbH docsAuthentication commercetools GmbH docsRate limits commercetools GmbH docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/commercetools and the Connections API.