Create Organization

Create a new Enterprise organization and assign an owner. The owner will receive an email with a temporary password and must activate their account before accessing the organization.

HTTP Method and URL

POST
{{host}}/api/v2/organizations?user_type=ENTERPRISE_API

Authentication Requirements

Requires a valid user token in the request headers.

Request Body

Send the following fields as multipart/form-data:

• name: Name of the organization (string, required)

• email: Organization email address (string, required)

• address: Organization address (string, required)

• sub_organization_type_name: Type of sub-organization (string, required)

Example Request

plaintextPOST {{host}}/api/v2/organizations?    user_type=ENTERPRISE_APIHeaders:  Authorization: Bearer {USER-TOKEN}Body (form-data):  name: test sub  email: [email protected]  address: address  sub_organization_type_name: Department

Example Successful Response

json{    "organization_id": "string",    "name": "string",    "email": "string",    "address": "string",    "sub_organization_type_name": "string"}

Error Responses

• 400 Bad Request: Missing or invalid fields in the request body.

• 401 Unauthorized: Authentication failed or missing token.

• 409 Conflict: Organization with the provided email already exists.

Usage Notes

• The owner must activate their account via the email sent before accessing the organization.

• Ensure all required fields are provided in the request body.