---
title: "discountCodeFreeShippingCreate"
description: "创建免运费折扣码"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-free-shipping-create'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-free-shipping-create.md'
---
# discountCodeFreeShippingCreate

创建免运费折扣码

- **Required Scopes:** `write_discounts`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Mutation

## Type Signature

`DiscountCodeFreeShippingCreatePayload`

## Required Permissions

* `write_discounts`

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

## Arguments

* `freeShippingCodeDiscount`

  [DiscountCodeFreeShippingInput!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-code-free-shipping-input.md)

  用于创建代码折扣的输入数据

## Returns

* `codeDiscountNode`

  [DiscountCodeNode](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-code-node.md)

  创建的代码折扣。

* `userErrors`

  [[DiscountUserError!]!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/discounts-and-marketing/objects/discount-user-error.md)

  执行突变时发生的错误列表

## Code Example

```graphql
mutation discountCodeFreeShippingCreate($freeShippingCodeDiscount: DiscountCodeFreeShippingInput! ) {
	discountCodeFreeShippingCreate(freeShippingCodeDiscount: $freeShippingCodeDiscount ) 
		 {
			# DiscountCodeFreeShippingCreatePayload fields
		}
		
	}

```

## Variables

```json
{
  "freeShippingCodeDiscount": {
    "appliesTimesPerCustomer": {},
    "code": "",
    "combinesWith": {
      "orderDiscounts": false,
      "productDiscounts": {},
      "shippingDiscounts": false
    },
    "customerSelection": {
      "all": false,
      "customerSegments": {
        "add": {},
        "remove": ""
      },
      "customers": {
        "add": "",
        "remove": ""
      }
    },
    "destination": {
      "all": false,
      "countries": {
        "add": "",
        "includeRestOfWorld": false,
        "remove": ""
      }
    },
    "endsAt": "{}",
    "maximumShippingPrice": "{}",
    "minimumRequirement": {
      "quantity": {
        "greaterThanOrEqualToQuantity": 0
      },
      "subtotal": {
        "greaterThanOrEqualToSubtotal": {}
      }
    },
    "startsAt": {},
    "title": {},
    "usageLimit": 0
  }
}
```

## Error Handling

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