---
title: "referralRecordCreate"
description: "根据邀请码，为邀请人与获邀人创建邀请关系。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/mutations/referral-record-create'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/mutations/referral-record-create.md'
---
# referralRecordCreate

根据邀请码，为邀请人与获邀人创建邀请关系。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Arguments

* `customerAccessToken`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  获邀人的客户访问令牌。

* `senderReferralCode`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/string.md)

  邀请人的邀请码。

## Returns

* `userErrors`

  [[MemberUserError!]!](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/member-user-error.md)

  创建邀请关系时遇到的错误。

* `senderCustomer`

  [ReferralSenderCustomer](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/referral-sender-customer.md)

  邀请人信息。

* `receiverCustomer`

  [ReferralReceiverCustomer](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/referral-receiver-customer.md)

  获邀人信息。

## Examples

### 为邀请人与获邀人创建邀请关系

根据邀请码，为邀请人与获邀人创建邀请关系

**Request:**

```json
mutation referralRecordCreate {
  referralRecordCreate(customerAccessToken:"tokenxxx",senderReferralCode:"7M**") 
  {
   senderCustomer{
                customerId
                email
                phone
                firstName
                lastName
                levelName
                levelCode
                referralUrl
                referralCode
         },
         receiverCustomer{
             customerId
                email
                phone
                firstName
                lastName
                levelName
                levelCode
                referralUrl
                referralCode
         }

  }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "referralRecordCreate": {
        "receiverCustomer": {
          "customerId": "gid://shopline/Customer/46037****",
          "firstName": "zha**",
          "lastName": "li",
          "levelCode": "gid://shopline/Membership/MLC644317****",
          "levelName": "middle",
          "email": "***@qq.com",
          "phone": "0086135604****",
          "referralCode": "G6***",
          "referralUrl": "https://****.myshopline.com/user/signUp?referral_code=G6***&source_type=member_plugin_referral&slt=member_plugin_referral"
        },
        "senderCustomer": {
          "email": "***@qq.com",
          "lastName": "mian***",
          "phone": "0086135604****",
          "referralUrl": "https://***.myshopline.com/user/signUp?referral_code=7M2***&source_type=member_plugin_referral&slt=member_plugin_referral",
          "customerId": "gid://shopline/Customer/420010****",
          "firstName": "zha**",
          "levelCode": "gid://shopline/Membership/MLC6443****",
          "levelName": "middle",
          "referralCode": "7M***"
        }
      }
    }
  }
}
```

## Error Handling

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