Categories

For a complete overview of the category endpoints, refer to the API documentation for Categories.

Create a category

To create a category, send a POST request to the following endpoint with the category data in the request body.

POST https://{YOUR-TENANT-NAME}.api.fulfillmenttools.com/api/categories

Example request body

{
  "nameLocalized": {
    "de_DE": "Lebensmittel",
    "en_US": "groceries"
  },
  "tenantCategoryId": "G-01"
}

A successful request returns a 201 CREATED response with a body that includes the id of the newly created category.

Example response body

{
    "lastModified": "2025-04-25T09:06:54.737Z",
    "version": 1,
    "nameLocalized": {
        "de_DE": "Lebensmittel",
        "en_US": "groceries"
    },
    "tenantCategoryId": "G-01",
    "id": "1f6fe169-893f-4e95-8ac0-38c9e6eca068",
    "created": "2025-04-25T09:06:54.737Z",
    "name": "groceries"
}