> For the complete documentation index, see [llms.txt](https://docs.ggwp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ggwp.com/chinese-simplified/shen-fen-yu-fang-wen-guan-li-iam/api-wen-dang-scim/yong-hu-api/chuang-jian-yong-hu.md).

# 创建用户

### 概述

在系统中创建一个新用户。

此端点在用户预配期间由 Okta 和 Microsoft Azure Active Directory 等身份提供商使用。

***

### 端点

```bash
POST /Users
```

***

### 完整 URL

```bash
https://api.ggwp.com/scim/v2/Users
```

***

### 身份验证

```http
Authorization: Bearer <access_token>
```

***

## 请求正文

### 示例

```json
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "userName": "Temp_user_prod",
  "externalId": "ABC1900BE",
  "name": {
    "givenName": "Temp",
    "familyName": "User"
  },
  "displayName": "Temp User",
  "emails": [
    {
      "value": "temp_user_us@example.com",
      "primary": true
    }
  ],
  "roles": [
    {
      "value": "admin"
    }
  ],
  "active": true
}
```

***

## 请求体参数

### schemas

* **类型：** `数组[字符串]`
* **必需：** 是
* **值：**  `urn:ietf:params:scim:schemas:core:2.0:User`&#x20;

***

### userName

* **类型：** `字符串`
* **必需：** 是
* **描述：** 用户的唯一标识符

***

### 名称

* **类型：** `对象`
* **必需：** 可选

#### 子属性

<table><thead><tr><th width="150.5">字段</th><th width="137.5">类型</th><th>描述</th></tr></thead><tbody><tr><td>givenName</td><td>字符串</td><td>名字</td></tr><tr><td>familyName</td><td>字符串</td><td>姓氏</td></tr></tbody></table>

***

### emails

* **类型：** `数组[对象]`
* **必需：** 是

#### 子属性

<table><thead><tr><th width="134.5">字段</th><th width="143">类型</th><th width="131.5">必需</th><th>描述</th></tr></thead><tbody><tr><td>值</td><td>字符串</td><td>✅</td><td>电子邮件地址</td></tr><tr><td>类型</td><td>字符串</td><td>❌</td><td>工作，家庭</td></tr><tr><td>主要</td><td>布尔值</td><td>❌</td><td>主电子邮件</td></tr></tbody></table>

***

### active

* **类型：** `布尔值`
* **必需：** 可选
* **默认：** `true`

***

## 响应

### 成功（200 OK）

```json
{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "c118d158-c11b-495b-ab88-f57c8ac473c0",
  "userName": "Temp_user_prod",
  "externalId": "ABC1900BE",
  "active": true,
  "name": {
    "givenName": "Temp",
    "familyName": "User"
  },
  "displayName": "Temp User",
  "emails": [
    {
      "value": "temp_user_us@example.com",
      "primary": true
    }
  ],
  "roles": [
    {
      "value": "admin"
    }
  ],
  "meta": {
    "resourceType": "User",
    "location": "https://api.ggwp.com/scim/v2/Users/c118d158-c11b-495b-ab88-f57c8ac473c0",
    "created": "2026-04-01T11:15:22Z",
    "lastModified": "2026-04-01T11:15:22Z"
  }
}
```

***

## 错误响应

### 400 错误请求

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "400",
  "detail": "无效请求"
}
```

***

### 409 冲突（重复用户）

```json
{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "status": "409",
  "detail": "具有此用户名的用户已存在"
}
```

***

## 验证规则

* `schemas` 必须存在且有效
* `userName` 必须唯一
* 电子邮件格式必须有效且唯一
* 重复用户必须返回 `409 冲突`
* 无效负载必须返回 `400`