Skip to main content
POST
Import Scx Sellers

Authorizations

Authorization
string
header
required

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

FlowAuthorization Code
Authorization URL
https://id.jtl-cloud.com/oauth/v2/authorize
Token URL
https://id.jtl-cloud.com/oauth/v2/token
Scopes1
saleschannels.write
Grants permission to create and modify sales channels.

Headers

Idempotency-Key
string

Optional, client-generated key for deduplicating repeated write requests. A repeated request with the same key returns the originally recorded result instead of executing the effect again.

Required string length: 1 - 255
x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Body

application/json

Request model for ImportScxSellers command endpoint. Route parameters bind from the route, query parameters from the query string, everything else from the body.

companyId
string<uuid>
required

ID of the company newly imported sellers are created under. Sellers already connected under a different company are left unchanged.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

Response

The newly connected sellers, if any.

Imports SCX sellers that have newly connected to the company since the last import. Idempotent on retry - returns an empty list if there is nothing new. - Response

newSalesChannelIds
string
required

Sales channel IDs of newly imported SCX sellers.