---
title: "POST organizations"
url: "https://developer-qual.migros.ch/apis/iam-api-qual-0/versions/7daa20ed-86cc-440b-9091-0d9a5cee4c9b/operations/postOrganizations"
---

> Full API specification: https://developer-qual.migros.ch/apis/iam-api-qual-0/versions/7daa20ed-86cc-440b-9091-0d9a5cee4c9b.md

# POST organizations

`POST` `/migros/iam/v2/Organizations`

Operation ID: `postOrganizations`

An endpoint for creating organization

## Request body (required)

Content types: `application/scim+json`

## Responses

- `201` - Created
- `500` - Internal Error

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: IAM API QUAL
  version: 0.1.0
servers:
  - description: URL of upstream IAM API in Azure Kubernetes
    url: https://iamapi-qs.service.migros.cloud
paths:
  /migros/iam/v2/Organizations:
    post:
      description: An endpoint for creating organization
      operationId: postOrganizations
      requestBody:
        content:
          application/scim+json:
            schema:
              properties:
                email:
                  type: string
                username:
                  type: string
              type: object
        description: Data to create a new organization
        required: true
      responses:
        "201":
          description: Created
        "500":
          description: Internal Error
      summary: POST organizations
      tags:
        - iam-api-tag
      x-kong-plugin-rate-limiting:
        config:
          hour: 50000
          second: 15
```