---
title: "Create a institution"
method: POST
path: "/institution"
tags: ["institution"]
---

# Create a institution

`POST /institution`

## Request body

- Institution
  - `id` string, required
  - `name` string, required — Name of institution
  - `external_identifier` object — Known external identifier of the institution
    - `regon` string
    - `nip` string
  - `address` AddressData
    - `email` string, email
    - `epuap` string, epuapId
    - `street` string
    - `postal_code` string
    - `city` string
    - `voivodeship` string
    - `house_no` string
    - `flat_no` string
  - `administrativeUnit` string, administrativeUnitId
  - `createdOn` string, datetime, required
  - `createdBy` string, required — User ID responsible for creating the content
  - `modifiedOn` string, datetime, required
  - `modifiedBy` string, required

## Response `201`

Expected response to a valid request

- Institution
  - `id` string, required
  - `name` string, required — Name of institution
  - `external_identifier` object — Known external identifier of the institution
    - `regon` string
    - `nip` string
  - `address` AddressData
    - `email` string, email
    - `epuap` string, epuapId
    - `street` string
    - `postal_code` string
    - `city` string
    - `voivodeship` string
    - `house_no` string
    - `flat_no` string
  - `administrativeUnit` string, administrativeUnitId
  - `createdOn` string, datetime, required
  - `createdBy` string, required — User ID responsible for creating the content
  - `modifiedOn` string, datetime, required
  - `modifiedBy` string, required

## Other responses

- `default` — unexpected error

---

[API](https://skmtc.net/watchdogpolska/apis/small-eod.md) · [All operations](https://skmtc.net/watchdogpolska/apis/small-eod/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/watchdogpolska/small-eod/revisions/1c5ac40bf412/schema)