Create Warranty Policy
POST/api/repairs/warranty-policies
Create Warranty Policy.
repairs:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Request fields:
name(required): string, max:120description(optional): string, max:5000customer_coverage_text(optional): string, max:5000term_type(required): Enum:in:"lifetime","months","none"term_months(required): integer, min:1, max:1200start_event(optional): Enum:in:"shipped","delivered","ordered","registered"product_id(optional): integer, exists:products,idproduct_category_id(optional): integer, exists:product_categories,idbrand_id(optional): integer, exists:product_brands,idsales_channel_id(optional): integer, exists:sales_channels,idsub_sales_channel_id(optional): integer, exists:sub_sales_channels,idcustomer_group(optional): In:in:"wholesale","dtc"purchased_from(optional): date_format:Y-m-dpurchased_to(optional): date_format:Y-m-d, after_or_equal:purchased_fromcovered_root_causes(required): arraycovered_root_causes.*(optional): string, Enum:in:"manufacturing_defect","wear_and_tear","accidental_damage","misuse","shipping_damage","no_fault_found","unknown"covered_issue_type_ids(optional): arraycovered_issue_type_ids.*(optional): integer, distinct, exists:repair_issue_types,idexcluded_issue_type_ids(optional): arrayexcluded_issue_type_ids.*(optional): integer, distinct, exists:repair_issue_types,idexcluded_order_tags(optional): array, max:50excluded_order_tags.*(optional): string, max:100excluded_product_tags(optional): array, max:50excluded_product_tags.*(optional): string, max:100decision_target_business_days(optional): integer, min:1, max:365proof_of_purchase(optional): Enum:in:"required","preferred","not_required"max_claims_per_unit(optional): integer, min:1, max:1000claim_cooldown_days(optional): integer, min:0, max:3650inbound_shipping(optional): Enum:in:"customer_pays","brand_pays","flat_fee"inbound_flat_fee(required): numeric, min:0, max:99999999return_shipping(optional): Enum:in:"customer_pays","brand_pays","flat_fee"return_flat_fee(required): numeric, min:0, max:99999999assessment_fee(optional): numeric, min:0, max:99999999out_of_coverage(optional): Enum:in:"paid_repair","discount_offer","decline"out_of_coverage_discount_pct(required): numeric, min:0, max:100preferred_resolutions(optional): arraypreferred_resolutions.*(optional): string, distinct, Enum:in:"repaired","parts_sent","replaced","refurbished_to_stock","unrepairable_credited","unrepairable_returned","no_faulallow_transfer(optional): booleanreturn_required(optional): booleansla_policy_id(optional): integer, exists:repair_sla_policies,idreserve_rate_pct(optional): numeric, min:0, max:100reserve_amount_per_unit(optional): numeric, min:0, max:99999999priority(optional): integer, min:0, max:100000is_active(optional): booleancomponent_terms(optional): array, max:50component_terms.*.component_label(required): string, max:80component_terms.*.issue_type_id(optional): integer, exists:repair_issue_types,idcomponent_terms.*.term_type(required): Enum:in:"lifetime","months","none"component_terms.*.term_months(required): integer, min:1, max:1200fee_guardrail_acknowledged(optional): boolean
Permission: repairs.manage_settings.
Authentication: Bearer token with the repairs:read / write scope.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.