---
title: "Create new Orgunit"
method: POST
path: "/orgunit"
tags: ["Orgunit"]
---

# Create new Orgunit

`POST /orgunit`

Provisions a new organization unit (brand) within your PBT account. This endpoint configures the base identification properties,  communication profiles, and physical address metadata for the brand,  automatically generating a unique campus identifier upon success.

## Request body

- OrgunitParam
  - `name` string, required — The official descriptive name of the new orgunit or brand.
  - `email` string, email, required — The primary administrative email address associated with the brand.
  - `contactNo` string — A primary contact phone number for the orgunit.
  - `imageURL` string, nullable — A direct URL hosting the brand's logo or profile avatar.
  - `details` string, nullable — Additional context or miscellaneous profile notes regarding the brand.
  - `address` Address
    - `address1` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `countryCode` string, nullable

## Response `201`

Success

- CampusIdResponseExternalApiResponseNew
  - `data` CampusIdResponse
    - `campusId` string, nullable
  - `appCode` string, nullable
  - `message` string, nullable
  - `isError` boolean

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/ministrybytext/apis/pbt-api-documentation.md) · [All operations](https://skmtc.net/ministrybytext/apis/pbt-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ministrybytext/pbt-api-documentation/versions/ca6e9c8f430d/schema)