Commercetools

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	🚫 (time to contribute: <48h)
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Pre-built integrations

No pre-built integration yet (time to contribute: <48h)

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	✅	Required for API access
Paid test account	✅	Recommended for testing
Partnership	❌	Not required
App review	❌	Not required
Security audit	❌	Not required

Setup guide

To integrate with Commercetools, follow these steps:

1. Create a Project: Log in to your Commercetools account and create a new project. Note down the Project Key.
2. Generate API Credentials: Navigate to the API Clients section in your project settings and create a new API client. Save the Client ID and Client Secret.
3. Configure Nango: Use the Client ID, Client Secret, and Project Key to set up the Commercetools integration in Nango.
4. Set Region: Specify the region (e.g., us, eu, au) where your Commercetools project is hosted.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

• Commercetools API Documentation
• OAuth 2.0 Authentication Guide
• Commercetools SDKs
• Commercetools Getting Started Guide

Contribute useful links by editing this page

API gotchas

• Scopes: Ensure you specify the correct scope (e.g., manage_project:your-project-key) when generating the OAuth token. Without the correct scope, API requests will fail.
• Token Expiry: Access tokens expire after 2 days (172800 seconds). Make sure to refresh the token before it expires.
• Region-Specific Endpoints: Use the correct region-specific endpoint (e.g., auth.us.commercetools.com for the US region) when making API requests.

Contribute API gotchas by editing this page

Connect to Commercetools

Guide to connect to Commercetools using Nango Connect.