Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guideDeveloper guideAdmin guide
Company siteHelp center
English
  • Русский
  • English
v74
  • v74
  • v73
  • v72
Login
  • User API documentation
  • API interaction
  • Matching
  • Profiles
  • Databases
  • Resources
  • Segments
  • Suppression lists
  • Templates and fragments
  • Campaigns
  • Mailings
  • Automation scenarios
  • Loyalty Programs
  • Promo codes
  • Goals
  • Application push notifications
  • Market
    • Market objects
      • Order data object
      • Product data object
      • SKU data object
      • Categories array
      • Custom fields array
    • Orders
    • Products and SKU
  • Analytic reports
  • SendersDev
  • External datatables queries
  • Objects
  • Miscellaneous
  • Importing the API collection in Postman
  • List of API endpoints
  • SDK
  • Market
  • Market objects
  • Categories array
Documentation for version v74

Categories array

The categories array is used to create categories and subcategories in the market. Each object creates one category. Passed in the following requests:

  • Import products, SKUs and categories
  • Import SKUs and categories

Request parameters​

ParameterTypeExampleRequiredDescription
external_idstring"1234"YesCategory ID
namestring"Cell phones and accessories"YesField name
parent_external_idstring"123"NoMain category ID. Passed if you create a subcategory.

JSON​

  • JSON
  • XML
[
{
"external_id": "123",
"name": "Test category",
},
{
"external_id": "12345",
"name": "Test subcategory",
"parent_external_id": "123"
}
]
<xml>
<external_id>123</external_id>
<name>Test category</name>
</row>
<row>
<external_id>12345</external_id>
<name>Test subcategory</name>
<parent_external_id>123</parent_external_id>
</xml>
Last updated on Feb 26, 2024
Previous
SKU data object
Next
Custom fields array
  • Request parameters
  • JSON
© 2015 - 2025 Altcraft, LLC. All rights reserved.