---
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

## Changes

> 16 revisions in range; 1 not diffed.

- **2019-10-10** `f16566c7c7ef` — 4 info
  - the response property `createdBy` became required for the status `201`
  - the response property `createdOn` became required for the status `201`
  - the response property `modifiedBy` became required for the status `201`
  - the response property `modifiedOn` became required for the status `201`

[Change history](https://skmtc.dev/watchdogpolska/apis/small-eod/changes/institution/post.md)

---

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