---
title: "Mark subscription as failed"
method: POST
path: "/customers/{customerId}/subscriptions/{subscriptionId}/fail"
tags: ["Subscriptions"]
---

# Mark subscription as failed

`POST /customers/{customerId}/subscriptions/{subscriptionId}/fail`

This endpoint is used to mark a subscription as failed.

If the subscription is in dunning, it'll be taken out of dunning.

If the shop has an actions set to trigger when a subscription is failed, they'll be triggered (example: email notifications).

## Path parameters

- `customerId` string, required
- `subscriptionId` string, required

## Response `200`

Updated subscription

- SubscriptionDynamo
  - `SubscriptionId` string — Identifier
  - `SubscriptionStatus` string — Status
  - `NextBillingDate` string, date-time — Date of the next billing

## Other responses

- `401` — You do not have permission
- `404` — Not Found

---

[API](https://skmtc.net/awtomic/apis/awtomic-api.md) · [All operations](https://skmtc.net/awtomic/apis/awtomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awtomic/awtomic-api/versions/dfe3dfce125c/schema)