---
title: "thirdUserCreate"
description: "在聊天应用或消息系统中创建新的第三方用户。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/third-user-create'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/mutations/third-user-create.md'
---
# thirdUserCreate

在聊天应用或消息系统中创建新的第三方用户。

- **Required Scopes:** `unauthenticated_write_message`
- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Required Permissions

* `unauthenticated_write_message`

接口访问需要令牌，具体如何获取令牌参考：[身份认证](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md)。

## Arguments

* `input`

  [ThirdUserCreateInput](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/inputs/third-user-create-input.md)

  用于创建第三方用户的输入字段。

## Returns

* `thirdUser`

  [ThirdUser](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/objects/third-user.md)

  第三方用户信息

* `userErrors`

  [[ThirdUserUserError!]!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/message/objects/third-user-user-error.md)

  与用户信息相关的错误。

## Examples

### 创建第三方用户

在聊天应用程序或消息系统中创建新的第三方用户。创建第三方用户是调用其他相关接口的前提条件。

**Request:**

```json
mutation ThirdUserCreate {
    thirdUserCreate(
        input: {
            userName: "vito"
            userId: "gid://shopline/ThirdUser/******5235111"
            userPhone: "+1213***5678"
            gender: MALE
        }
    ) {
        userErrors {
            code
            field
            message
        }
        thirdUser {
            id
        }
    }
}
```

**Response:**

```json
{
  "data": {
    "thirdUserCreate": {
      "thirdUser": {
        "id": "gid://shopline/ThirdUser/******5235111"
      },
      "userErrors": []
    }
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/storefront-api/overview.md#status-and-error-codes)。