---
title: "POST /{merchantId}/returnpolicyonline"
method: POST
path: "/{merchantId}/returnpolicyonline"
tags: ["returnpolicyonline"]
---

# POST /{merchantId}/returnpolicyonline

`POST /{merchantId}/returnpolicyonline`

Creates a new return policy.

## Path parameters

- `merchantId` string, required

## Request body

- ReturnPolicyOnline — Return policy online object. This is currently used to represent return policies for ads and free listings programs.
  - `restockingFee` ReturnPolicyOnlineRestockingFee — The restocking fee. This can either be a fixed fee or a micro percent.
    - `fixedFee` PriceAmount — The price represented as a number and currency.
      - `value` string — The price represented as a number.
      - `currency` string — The currency of the price.
    - `microPercent` integer — Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.
  - `returnMethods` string[] — The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
  - `policy` ReturnPolicyOnlinePolicy — The available policies.
    - `type` 'TYPE_UNSPECIFIED' | 'NUMBER_OF_DAYS_AFTER_DELIVERY' | 'NO_RETURNS' | 'LIFETIME_RETURNS' — Policy type.
    - `days` string, int64 — The number of days items can be returned after delivery, where one day is defined to be 24 hours after the delivery timestamp. Required for `numberOfDaysAfterDelivery` returns.
  - `returnPolicyUri` string — The return policy uri. This can used by Google to do a sanity check for the policy.
  - `itemConditions` string[] — The item conditions that are accepted for returns. This is required to not be empty unless the type of return policy is noReturns.
  - `returnPolicyId` string — Output only. Return policy ID generated by Google.
  - `name` string — The name of the policy as shown in Merchant Center.
  - `countries` string[] — The countries of sale where the return policy is applicable. The values must be a valid 2 letter ISO 3166 code, e.g. "US".
  - `label` string — The unique user-defined label of the return policy. The same label cannot be used in different return policies for the same country. Policies with the label 'default' will apply to all products, unless a product specifies a return_policy_label attribute.
  - `returnReasonCategoryInfo` ReturnPolicyOnlineReturnReasonCategoryInfo[] — The return reason category information. This required to not be empty unless the type of return policy is noReturns.
    - `returnLabelSource` 'RETURN_LABEL_SOURCE_UNSPECIFIED' | 'DOWNLOAD_AND_PRINT' | 'IN_THE_BOX' | 'CUSTOMER_RESPONSIBILITY' — The corresponding return label source. If the `ReturnMethod` field includes `BY_MAIL`, it is required to specify `ReturnLabelSource` for both `BUYER_REMORSE` and `ITEM_DEFECT` return reason categories.
    - `returnReasonCategory` 'RETURN_REASON_CATEGORY_UNSPECIFIED' | 'BUYER_REMORSE' | 'ITEM_DEFECT' — The return reason category.
    - `returnShippingFee` ReturnPolicyOnlineReturnShippingFee — The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost.
      - `type` 'TYPE_UNSPECIFIED' | 'FIXED' | 'CUSTOMER_PAYING_ACTUAL_FEE' — Type of return shipping fee.
      - `fixedFee` PriceAmount — The price represented as a number and currency.
        - `value` string — The price represented as a number.
        - `currency` string — The currency of the price.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/content.md) · [All operations](https://skmtc.net/google/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/content/revisions/1033388fc86f/schema)