v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB
Categories

Create Category

Create category with a specific name and hierarchy.

post/v1/categories

Request body

namestring required

Category name.

hierarchyinteger required

Category hierarchy. Categories with lower hierarchy are processed before categories with higher hierarchy value.

Response

Returns a newly created category object.

idstring required

Unique category ID assigned by Voucherify.

namestring required

Category name.

hierarchyinteger required

Category hierarchy. Categories with lower hierarchy are processed before categories with higher hierarchy value.

object'category' required
created_atstring date-time required

Timestamp representing the date and time when the category was created. The value is shown in the ISO 8601 format.

Example response

{
  "created_at": "2022-07-14T10:45:13.156Z"
}