Skip to main content
The JTL ERP API lets you read and modify JTL-Wawi data: orders, products, customers, stock, and more. Every merchant runs the same Wawi API on their own Wawi instance. What differs is how your integration reaches it. The Cloud option is available when a merchant has connected their Wawi to JTL Cloud. The public endpoint forwards requests to their Wawi, letting your integration run off the merchant’s premises without access to their network. Both variants expose the same API surface through REST and GraphQL. They differ in:
  • where your integration can be deployed
  • how authentication works
  • a small set of variant-specific Capabilities

​
Authentication

The authentication flow depends on the variant. Cloud uses OAuth 2.0 client credentials; OnPremise uses a two-step registration flow.
1

Register in the Partner Portal

Register your app in the JTL Partner Portal to receive a clientId and clientSecret.
2

Request an access token

Send a POST request to https://auth.jtl-cloud.com/oauth2/token with Basic auth (base64 clientId:clientSecret) and body grant_type=client_credentials. The response returns a JWT access token valid for 24 hours.
3

Call the API

Include the JWT as Authorization: Bearer <JWT> on every request, along with the merchant’s X-Tenant-ID.
See the OAuth 2.0 flow for more details.

​
Required HTTP Headers

Every API request must include the headers below:
See the versioning guide for more details on API versioning.

​
What’s Next?

Available APIs

A guided tour of the REST API domains and what each one does.

Authentication

Auth flows across Cloud Apps, OnPremise, and SCX.

API Reference

Browse all REST API endpoints with request/response schemas.