createCustomPolicy

v1.0.0

This method creates a new custom policy in which a seller specifies their terms for complying with local governmental regulations.

Two Custom Policy types are supported:

Product Compliance (PRODUCT_COMPLIANCE)
Takeback (TAKE_BACK)

Each Custom Policy targets a policyType and eBay marketplace combination. Multiple policies may be created as follows:

Product Compliance: a maximum of 10 policies per eBay marketplace may be created
Takeback: a maximum of 3 policies per eBay marketplace may be created

A successful create policy call returns an HTTP status code of 201 Created with the system-generated policy ID included in the Location response header.

Product Compliance Policy

Product Compliance policies disclose product information as required for regulatory compliance.

Note: A maximum of 10 Product Compliance policies per eBay marketplace may be created.

Takeback Policy

Takeback policies describe the seller's legal obligation to take back a previously purchased item when the buyer purchases a new one.

Note: A maximum of 3 Takeback policies per eBay marketplace may be created.

Input

{
  "type": "object",
  "properties": {
    "X-EBAY-C-MARKETPLACE-ID": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "Details of the seller's specific policy and terms for this policy.<br/><br/><b>Max length:</b> 15,000"
    },
    "label": {
      "type": "string",
      "description": "Customer-facing label shown on View Item pages for items to which the policy applies. This seller-defined string is displayed as a system-generated hyperlink pointing to detailed policy information.<br/><br/><b>Max length:</b> 65"
    },
    "name": {
      "type": "string",
      "description": "The seller-defined name for the custom policy. Names must be unique for policies assigned to the same seller, policy type, and eBay marketplace.<br /><span class=\"tablenote\"><strong>Note:</strong> This field is visible only to the seller. </span><br/><br/><b>Max length:</b> 65"
    },
    "policyType": {
      "type": "string",
      "description": "Specifies the type of custom policy being created. <br/><br/>Two Custom Policy types are supported: <ul><li>Product Compliance (PRODUCT_COMPLIANCE)</li> <li>Takeback (TAKE_BACK)</li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/account/types/api:CustomPolicyTypeEnum'>eBay API documentation</a>"
    }
  },
  "required": [
    "X-EBAY-C-MARKETPLACE-ID"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object"
}