---
title: "POST /organizations/"
method: POST
path: "/organizations/"
tags: ["organizations"]
---

# POST /organizations/

`POST /organizations/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/organizations/`
- Auth: API key in header `Authorization`

Create a new organization.

## Request body

- object
  - `id` integer
  - `external_id` string, nullable: Id of the organization in the API consumer's systems
  - `name` string, required: Name of the organization
  - `description` string: Description of the organization
  - `logo` string, uri: Link to the organization logo
  - `creator` integer: User who created the organization
  - `owner` integer, nullable: Owner of the organization
  - `address` string: Address of the organization
  - `website` string: Website of the organization
  - `is_public` boolean: Whther the organization and its details are visible to all users
  - `is_visible` boolean: Whether an organization minimal details are visible to all users
  - `custom_fields` object: Organization values for custom fields defined in Manatal.
  - `created_at` string, date-time: Date at which the organization was created
  - `updated_at` string, date-time

## Response `201`

- object
  - `id` integer
  - `external_id` string, nullable: Id of the organization in the API consumer's systems
  - `name` string, required: Name of the organization
  - `description` string: Description of the organization
  - `logo` string, uri: Link to the organization logo
  - `creator` integer: User who created the organization
  - `owner` integer, nullable: Owner of the organization
  - `address` string: Address of the organization
  - `website` string: Website of the organization
  - `is_public` boolean: Whther the organization and its details are visible to all users
  - `is_visible` boolean: Whether an organization minimal details are visible to all users
  - `custom_fields` object: Organization values for custom fields defined in Manatal.
  - `created_at` string, date-time: Date at which the organization was created
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)