Skip to main content
POST
/
v1
/
authentication
/
login
Login
curl --request POST \
  --url https://api.jtl-cloud.com/erp/v1/authentication/login \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-challengecode: <x-challengecode>' \
  --header 'x-tenant-id: <x-tenant-id>' \
  --data '
{
  "UserName": "<string>",
  "Password": "<string>"
}
'
{
  "SessionId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

​
x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

​
x-challengecode
string
required

You can enter any custom value here. The X-ChallengeCode is used during app registration and must be the same for all registration requests. The maximum length is 30 characters.

Body

application/json

Contains the login information

Model Class: CreateLogin

​
UserName
string
required

Username of the WAWI user

​
Password
string
required

Password of the WAWI user

Response

login success

Model Class: Login

​
SessionId
string
required

Unique identifier of the current session