User GuidesAPI ReferenceRelease NotesEnrichment APIs
Doc HomeHelp CenterLog In

Bulk upload categories to a categorization project

Bulk creating categories takes the same form as creating one category. It requires a path for each category you want to add from the parent (root) to the category (node), including the category itself.

Each parent category must already exist. However, both parents and children can be created in the same call as long as the parent is created before the child in the ordering of the body. For example:

{"path":["Tier One Category"]}
{"path":["Tier One Category", "Tier Two Category"]}
{"path":["Another Tier One Category"]}
{"path":["Another Tier One Category", "Other Tier Two Category"]}
{"path":["Tier One Category", "Tier Two Category", "Tier Three Category"]}

The call returns an object with metadata concerning the creation.

Key

Value Description

numCategoriesCreated

The number of newly created categories.

allCategoriesSuccessful

Boolean. True if all categories were successfully created or already exist.

validationErrors

If the call fails, a detailed error message describing the issue.

Language
Click Try It! to start a request and see the response here!