---
title: "Create Company Organization"
method: POST
path: "/api/companies/{company_uuid}/organizations/create"
tags: ["company-organizations"]
---

# Create Company Organization

`POST /api/companies/{company_uuid}/organizations/create`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/organizations/create`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Headers

- `X-Teamspace-Uuid` string, uuid, nullable
- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Request body

- CompanyOrganizationCreate: Schema for creating a private organization within a company context
  - `name` string, required
  - `type` 'association' | 'government_body' | 'service_provider' | 'political_party', required
  - `short_name` string, nullable
  - `description` string, nullable
  - `info` object, nullable
  - `sentiment` string, nullable
  - `parent_organization_uuids` string[], nullable
  - `first_interaction` string, date-time, nullable
  - `last_interaction` string, date-time, nullable
  - `total_interactions_count` integer, nullable
  - `sentiment_score` integer, nullable
  - `sentiment_variation` 'positive' | 'negative' | 'neutral'
  - `contacts_total` integer, nullable
  - `government_body_types` GovernmentBodyTypeEnum[]
  - `service_provider_types` ServiceProviderTypeEnum[]
  - `country_id` integer, required
  - `visibility` 'company' | 'personal'

## Response `201`

Successful Response

- CompanyOrganizationResponse: Response schema for company organization operations
  - `name` string, required
  - `type` 'association' | 'government_body' | 'service_provider' | 'political_party', required
  - `short_name` string, nullable
  - `description` string, nullable
  - `info` object, nullable
  - `sentiment` string, nullable
  - `parent_organization_uuids` string[], nullable
  - `first_interaction` string, date-time, nullable
  - `last_interaction` string, date-time, nullable
  - `total_interactions_count` integer, nullable
  - `sentiment_score` integer, nullable
  - `sentiment_variation` 'positive' | 'negative' | 'neutral'
  - `contacts_total` integer, nullable
  - `government_body_types` GovernmentBodyTypeEnum[]
  - `service_provider_types` ServiceProviderTypeEnum[]
  - `uuid` string, uuid4, required
  - `company_data` OrganizationCompanyData[], required
    - `first_interaction` string, date-time, nullable
    - `last_interaction` string, date-time, nullable
    - `total_interactions_count` integer, nullable
    - `sentiment_score` integer, nullable
    - `sentiment_variation` 'positive' | 'negative' | 'neutral'
    - `contacts_total` integer, nullable
    - `visibility` string
    - `personal_owner_user_uuid` string, uuid4, nullable
  - `is_private` boolean, required
  - `is_selected` boolean: Whether this organization is selected for the company
  - `country` OrganizationCountry, required: Schema for countries that are associated with an organization
    - `id` integer, required
    - `name` string, required
  - `owners` UserBase[]: List of owners from the requesting company
    - `uuid` string, uuid4, required
    - `name` string, required
    - `phone_number` string, nullable
    - `email` string, email, required
    - `avatar_file_name` string, nullable
    - `ui_language` 'en' | 'pt' | 'es', nullable
    - `avatar_url` string, nullable, required: Get the avatar URL based on the filename if one exists
  - `collections` string[]
  - `groups` OrganizationGroupSummary[]: Áreas responsáveis pela organização na company
    - `uuid` string, uuid4, required
    - `name` string, required
  - `parents` OrganizationParentSummary[]
    - `uuid` string, uuid4, required
    - `name` string, required
    - `short_name` string, nullable
    - `type` 'association' | 'government_body' | 'service_provider' | 'political_party', required
    - `is_private` boolean, required

## Other responses

- `422`: Validation Error

---

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