---
title: "Create a new organization"
method: POST
path: "/organizations/"
tags: ["organizations"]
---

# Create a new organization

`POST /organizations/`

## Request

- Base URL: `https://dados.gov.pt/api/1`
- URL: `https://dados.gov.pt/api/1/organizations/`
- Auth: none declared

## Headers

- `X-Fields` string, mask

## Request body

- Organization
  - `acronym` string: The organization acronym
  - `badges` BadgeRead[]: The organization badges
    - `kind` string, required
  - `business_number_id` string: The organization's business identification number.
  - `created_at` string, date-time: The organization creation date
  - `deleted` string, date-time: The organization deletion date if deleted
  - `description` string, markdown, required: The organization description in Markdown
  - `extras` object: Extras attributes as key-value pairs
  - `id` string: The organization identifier
  - `last_modified` string, date-time: The organization last modification date
  - `logo` string: The organization logo URL
  - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version.
  - `members` Member[]
    - `label` string
    - `role` 'admin' | 'editor' | 'partial_editor', required: The member role in the organization
    - `since` string, date-time: The date the user joined the organization
    - `user` MemberUserWithEmail
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `avatar` string: The user avatar URL
      - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
      - `first_name` string: The user first name
      - `last_name` string: The user larst name
      - `page` string: The user web page URL
      - `slug` string: The user permalink string
      - `uri` string: The API URI for this user
      - `email` object: The user email (only present on show organization endpoint if the current user is member of the organization: admin or editor)
      - `last_login_at` object: The user last connection date (only present on show organization endpoint if the current user is member of the organization: admin or editor)
  - `metrics` object: The organization metrics
  - `name` string, required: The organization name
  - `page` string: The organization web page URL
  - `permissions` OrganizationPermissions
    - `delete` boolean
    - `edit` boolean
    - `harvest` boolean
    - `members` boolean
    - `private` boolean
  - `slug` string: The organization string used as permalink
  - `uri` string: The API URI for this organization
  - `url` string: The organization website URL

## Response `201`

Success

- Organization
  - `acronym` string: The organization acronym
  - `badges` BadgeRead[]: The organization badges
    - `kind` string, required
  - `business_number_id` string: The organization's business identification number.
  - `created_at` string, date-time: The organization creation date
  - `deleted` string, date-time: The organization deletion date if deleted
  - `description` string, markdown, required: The organization description in Markdown
  - `extras` object: Extras attributes as key-value pairs
  - `id` string: The organization identifier
  - `last_modified` string, date-time: The organization last modification date
  - `logo` string: The organization logo URL
  - `logo_thumbnail` string: The organization logo thumbnail URL. This is the square (100x100) and cropped version.
  - `members` Member[]
    - `label` string
    - `role` 'admin' | 'editor' | 'partial_editor', required: The member role in the organization
    - `since` string, date-time: The date the user joined the organization
    - `user` MemberUserWithEmail
      - `class` string, required: The object class
      - `id` string, required: The object unique identifier
      - `avatar` string: The user avatar URL
      - `avatar_thumbnail` string: The user avatar thumbnail URL. This is the square (500x500) and cropped version.
      - `first_name` string: The user first name
      - `last_name` string: The user larst name
      - `page` string: The user web page URL
      - `slug` string: The user permalink string
      - `uri` string: The API URI for this user
      - `email` object: The user email (only present on show organization endpoint if the current user is member of the organization: admin or editor)
      - `last_login_at` object: The user last connection date (only present on show organization endpoint if the current user is member of the organization: admin or editor)
  - `metrics` object: The organization metrics
  - `name` string, required: The organization name
  - `page` string: The organization web page URL
  - `permissions` OrganizationPermissions
    - `delete` boolean
    - `edit` boolean
    - `harvest` boolean
    - `members` boolean
    - `private` boolean
  - `slug` string: The organization string used as permalink
  - `uri` string: The API URI for this organization
  - `url` string: The organization website URL

## Other responses

- `400`: Validation error

---

[API](https://skmtc.dev/dados/apis/udata-api.md) - [All operations](https://skmtc.dev/dados/apis/udata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dados/apis/udata-api/revisions/77edaf8a00ea?raw)