---
title: "POST users"
url: "https://developer.migros.ch/apis/iam-api-0/versions/976fd3d6-52b0-46fb-8b82-33f4b00b51db/operations/postUsers"
---

> Full API specification: https://developer.migros.ch/apis/iam-api-0/versions/976fd3d6-52b0-46fb-8b82-33f4b00b51db.md

# POST users

`POST` `/migros/iam/v2/Users`

Operation ID: `postUsers`

An endpoint for creating user data

## 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
  version: 0.1.0
servers:
  - description: URL of upstream IAM API in Azure Kubernetes
    url: https://iamapi.service.migros.cloud
paths:
  /migros/iam/v2/Users:
    post:
      description: An endpoint for creating user data
      operationId: postUsers
      requestBody:
        content:
          application/scim+json:
            schema:
              properties:
                email:
                  type: string
                username:
                  type: string
              type: object
        description: Data to create a new user
        required: true
      responses:
        "201":
          description: Created
        "500":
          description: Internal Error
      summary: POST users
      tags:
        - iam-api-tag
      x-kong-plugin-rate-limiting:
        config:
          hour: 50000
          second: 15
```