Skip to main content

Create Business Category (v1)

Create a new business category.

Method & Path​

POST /v1/admin/business-categories

Description​

Creates a new business category with localized names and descriptions.

Authentication​

Required: Admin authentication with businesses.manage permission.

Request Body​

{
  "name": {
    "en": "Beauty Salon",
    "ar": "صالون تجميل"
  },
  "slug": "beauty-salon",
  "description": {
    "en": "Beauty and wellness services",
    "ar": "خدمات التجميل والعافية"
  }
}

Response 201 Created​

{
  "category": {
    "id": "507f1f77bcf86cd799439011",
    "name": {
      "en": "Beauty Salon",
      "ar": "صالون تجميل"
    },
    "slug": "beauty-salon"
  }
}

Common Errors​

  • 401 Unauthorized: Missing or invalid admin authentication token
  • 403 Forbidden: Insufficient permissions
  • 400 Bad Request: Invalid request body
  • 409 Conflict: Category with same slug already exists
  • 500 Internal Server Error: Server error