---
title: "Create warranty event"
method: POST
path: "/api/public/v1/subscriptions/{id}/warranty_event"
tags: ["Subscriptions"]
---

# Create warranty event

`POST /api/public/v1/subscriptions/{id}/warranty_event`

Track a warranty event (repair or replacement) for a subscription. Creates a subscription event of type "warranty" with the provided details. Triggers a warranty usage notification email to the shopper.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `type` 'repair' | 'replacement', required — Warranty event sub-type
  - `name` string — Name of the warranty claim
  - `description` string — Description of the warranty claim
  - `charged_amount` integer, required — Amount charged in cents
  - `product_id` string, required — Product identifier (cart item ID or UUID)

## Response `201`

warranty event created successfully

## Other responses

- `401` — unauthorized
- `422` — invalid product_id

---

[API](https://skmtc.dev/sequra/apis/checkout-api.md) · [All operations](https://skmtc.dev/sequra/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequra/checkout-api/revisions/2b0b60c52d04/schema)