action api_create_custom_policy {
label: "createCustomPolicy"
description: "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."
provider: api
method: POST
path: "/custom_policy/"
encoding: json
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.
Max length: 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.
Max length: 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.
Note: This field is visible only to the seller.
Max length: 65"
}
policyType: {
type: "string"
description: "Specifies the type of custom policy being created.
Two Custom Policy types are supported: - Product Compliance (PRODUCT_COMPLIANCE)
- Takeback (TAKE_BACK)
For implementation help, refer to eBay API documentation"
}
}
required: ["X-EBAY-C-MARKETPLACE-ID"]
additionalProperties: false
}
output: {
type: "object"
}
}