---
title: "POST /api/franchisee"
method: POST
path: "/api/franchisee"
tags: ["Franchisees"]
---

# POST /api/franchisee

`POST /api/franchisee`

## Request

- Base URL: `https://api.khaasfood.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.khaasfood.com/api/franchisee`
- Auth: OAuth 2
  - Authorization code: `https://api.khaasfood.com/connect/authorize`
  - Token URL: `https://api.khaasfood.com/connect/token`

## Request body

- KhaasFoodFranchiseesDTOsCreateFranchiseeDto
  - `name` string, required
  - `contactNumber` string, required
  - `email` string, email, nullable
  - `location` string, nullable
  - `isActive` boolean
  - `internalNote` string, nullable

## Response `200`

Success

- KhaasFoodFranchiseesDTOsFranchiseeDto
  - `id` string, uuid
  - `name` string, nullable
  - `contactNumber` string, nullable
  - `email` string, nullable
  - `location` string, nullable
  - `isActive` boolean
  - `internalNote` string, nullable
  - `status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
  - `statusDisplayName` string, nullable
  - `creationTime` string, date-time
  - `comments` KhaasFoodFranchiseesDTOsFranchiseeCommentDto[], nullable
    - `time` string, date-time
    - `comment` string, nullable
    - `userName` string, nullable
    - `userEmail` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Server Error
- `501`: Server Error

## Changes

> 11 revisions in range; 1 not diffed.

- **2026-10-07** `89e4afdc079d`: 1 breaking, 7 warning, 7 info
  - the `comments` response's property type changed from `string` to `array` for status `200` (media type: application/json)
  - removed the request property `comments` (media type: application/json-patch+json)
  - removed the request property `comments` (media type: application/json)
  - removed the request property `comments` (media type: text/json)
  - …11 more

[Operation history](https://skmtc.dev/khaasfood/apis/khaasfood-api/changes/api/franchisee/post.md)

---

[API](https://skmtc.dev/khaasfood/apis/khaasfood-api.md) - [All operations](https://skmtc.dev/khaasfood/apis/khaasfood-api/llms.txt) - [OpenAPI document](https://skmtc.dev/khaasfood/apis/khaasfood-api/revisions/149b6034bea9?raw)
