API reference

Imports

Record what you listed and map your variant ids to ours.

get/importsYour imported products and their sync status post/importsMark products as imported and map your variant ids to ours delete/imports/{id}Stop syncing a product post/imports/{id}/sync-resultReport whether applying our last change to your store worked

Your imported products and their sync status

get/imports

Parameters

`status` query · enum	`okfailedremoved`
`limit` query · integer	Default 50
`cursor` query · string	`nextCursor` from the previous page

Example request

curl "https://backend.markitmall.com/dropship/v1/imports" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

`data`required Import[]	—
`nextCursor`required string \| null	—

Example response

JSON

{
  "data": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "productId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "externalProductId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "syncStatus": "ok",
      "available": true,
      "variants": [
        {}
      ]
    }
  ],
  "nextCursor": "string"
}

Errors: 401 — the body is always { error: { code, message, details } }.

Mark products as imported and map your variant ids to ours

post/imports

Send one product, or { products: [...] } (up to 50). Re-importing updates the mapping. Map variants so orders can use your own externalVariantId.

Request body

Either

ImportRequest

`productId`required string	—
`externalProductId` string	—
`customTitle` string	—
`resalePrice` integer	—
`variants` object[]	—
`variants[].variantId`required string	—
`variants[].externalVariantId`required string	—
`variants[].externalSku` string	—

products

ImportRequest[] · max 50 items

—

Example request

curl -X POST "https://backend.markitmall.com/dropship/v1/imports" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
  "productId": "66f0c2a1b2c3d4e5f6a7b8c9",
  "externalProductId": "66f0c2a1b2c3d4e5f6a7b8c9",
  "customTitle": "string",
  "resalePrice": 1500,
  "variants": [
    {
      "variantId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "externalVariantId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "externalSku": "string"
    }
  ]
}'

Response 201 — Created

data

Import[]

—

Example response

JSON

{
  "data": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "productId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "externalProductId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "syncStatus": "ok",
      "available": true,
      "variants": [
        {}
      ]
    }
  ]
}

Errors: 400, 401, 404 — the body is always { error: { code, message, details } }.

Stop syncing a product

delete/imports/{id}

Parameters

idrequired

path · string

Example request

curl -X DELETE "https://backend.markitmall.com/dropship/v1/imports/{id}" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

An object; its fields are not fixed.

Example response

JSON

{}

Errors: 401, 404 — the body is always { error: { code, message, details } }.

Report whether applying our last change to your store worked

post/imports/{id}/sync-result

Parameters

idrequired

path · string

Request body

`status`required enum	— `okfailed`
`error` string	—

Example request

curl -X POST "https://backend.markitmall.com/dropship/v1/imports/{id}/sync-result" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "ok",
  "error": "string"
}'

Response 200

An object; its fields are not fixed.

Example response

JSON

{}

Errors: 401, 404 — the body is always { error: { code, message, details } }.